cvs: phpdoc /fr/functions ftp.xml
| From: | Damien Seguy | Date: | Tue, 17 Jul 2001 16:06:32 +0000 |
| Subject: | cvs: phpdoc /fr/functions ftp.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336281@lists.php.net to get a copy of this message | ||
dams Tue Jul 17 12:06:32 2001 EDT
Modified files:
/phpdoc/fr/functions ftp.xml
Log:
Major typos corrections.
Index: phpdoc/fr/functions/ftp.xml diff -u phpdoc/fr/functions/ftp.xml:1.6 phpdoc/fr/functions/ftp.xml:1.7 --- phpdoc/fr/functions/ftp.xml:1.6 Sat Jul 7 18:22:08 2001 +++ phpdoc/fr/functions/ftp.xml Tue Jul 17 12:06:31 2001 @@ -1,20 +1,22 @@ - <reference id="ref.ftp"> - <title>FTP</title> - <titleabbrev>FTP</titleabbrev> - <partintro> - <para> - FTP : File Transfer Protocol (Protocole de transfert de fichiers). - </para> - <para> - Les constantes suivantes sont définies dans le module FTP : - <constant>FTP_ASCII</constant> et <constant>FTP_BINARY</constant>. - </para> +<reference id="ref.ftp"> + <title>FTP</title> + <titleabbrev>FTP</titleabbrev> + <partintro> + <para> + FTP : File Transfer Protocol (Protocole de transfert de fichiers). + Ces fonctions implémentent un client pour accéder aux serveurs FTP, + comme défini dans &spec.ftp;. + </para> + <para> + Les constantes suivantes sont définies dans le module FTP : + <constant>FTP_ASCII</constant> et <constant>FTP_BINARY</constant>. + </para> <para> - <example> - <title>Exemple de connexion FTP</title> - <programlisting role="php"> + <example> + <title>Exemple de connexion FTP</title> + <programlisting role="php"> <?php -// création de la connection +// création de la connexion $conn_id = ftp_connect("$ftp_server"); // authentification avec nom de compte et mot de passe $login_result = ftp_login($conn_id, "$ftp_user_name", "$ftp_user_pass"); @@ -37,497 +39,541 @@ // fermeture de la connexion FTP. ftp_quit($conn_id); ?> - </programlisting> - </example> - </para> </partintro> - <refentry id="function.ftp-connect"> - <refnamediv> - <refname>ftp_connect</refname> - <refpurpose>Ouvre une connexion FTP</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </example> + </para> + </partintro> + <refentry id="function.ftp-connect"> + <refnamediv> + <refname>ftp_connect</refname> + <refpurpose>Ouvre une connexion FTP</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>resource <function>ftp_connect</function></funcdef> <paramdef>string <parameter>host</parameter></paramdef> <paramdef>int <parameter><optional>port</optional> - </parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_connect</function> retourne un flot <acronym>FTP</acronym> - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_connect</function> ouvre une connexion FTP avec l'hôte - <parameter>host</parameter>. Le paramètre <parameter>port</parameter> - spécifie le port de connexion. Si il est omis, le port 21 sera - utilisé. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-login"> - <refnamediv> - <refname>ftp_login</refname> - <refpurpose>Authentification d'une connexion FTP</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_login</function></funcdef> + </parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_connect</function> retourne un flot <acronym>FTP</acronym> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_connect</function> ouvre une connexion FTP avec l'hôte + <parameter>host</parameter>. Le paramètre <parameter>port</parameter> + spécifie le port de connexion. S'il est omis, le port 21 sera + utilisé. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-login"> + <refnamediv> + <refname>ftp_login</refname> + <refpurpose>Authentification d'une connexion FTP</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_login</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>username</parameter></paramdef> <paramdef>string <parameter>password</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_login</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_login</function> authentifie le flot FTP. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-pwd"> - <refnamediv> - <refname>ftp_pwd</refname> - <refpurpose>Retourne le nom du dossier courant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_pwd</function></funcdef> - <paramdef>resource <parameter>ftp_stream</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_pwd</function> retourne le nom du dossier courant, - ou &false; en cas d'erreur. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-cdup"> - <refnamediv> - <refname>ftp_cdup</refname> - <refpurpose>Change de dossier, et passe au dossier parent.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_cdup</function></funcdef> - <paramdef>resource <parameter>ftp_stream</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_cdup</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_cdup</function> change de dossier, et passe au dossier parent. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-chdir"> - <refnamediv> - <refname>ftp_chdir</refname> - <refpurpose>Change le dossier courant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_chdir</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_login</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_login</function> authentifie le flot FTP. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-pwd"> + <refnamediv> + <refname>ftp_pwd</refname> + <refpurpose>Retourne le nom du dossier courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ftp_pwd</function></funcdef> + <paramdef>resource <parameter>ftp_stream</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_pwd</function> retourne le nom du dossier courant, + ou <literal>FALSE</literal> en cas d'erreur. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-cdup"> + <refnamediv> + <refname>ftp_cdup</refname> + <refpurpose>Change de dossier, et passe au dossier parent.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_cdup</function></funcdef> + <paramdef>resource <parameter>ftp_stream</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_cdup</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_cdup</function> change de dossier, et passe au dossier parent. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-chdir"> + <refnamediv> + <refname>ftp_chdir</refname> + <refpurpose>Change le dossier courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_chdir</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>directory</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_chdir</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_chdir</function> change le dossier courant en - <parameter>directory</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-mkdir"> - <refnamediv> - <refname>ftp_mkdir</refname> - <refpurpose>Crée un dossier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_chdir</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_chdir</function> change le dossier courant en + <parameter>directory</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-mkdir"> + <refnamediv> + <refname>ftp_mkdir</refname> + <refpurpose>Crée un dossier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>ftp_mkdir</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>directory</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_mkdir</function> retourne le nom du dossier ainsi créé - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_mkdir</function> crée le dossier nommé - <parameter>directory</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-rmdir"> - <refnamediv> - <refname>ftp_rmdir</refname> - <refpurpose>Efface un dossier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_rmdir</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_mkdir</function> retourne le nom du dossier ainsi créé + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_mkdir</function> crée le dossier nommé + <parameter>directory</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-rmdir"> + <refnamediv> + <refname>ftp_rmdir</refname> + <refpurpose>Efface un dossier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_rmdir</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>directory</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_rmdir</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_rmdir</function> efface le dossier <parameter>directory</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-nlist"> - <refnamediv> - <refname>ftp_nlist</refname> - <refpurpose>Retourne la liste des fichiers dans un dossier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_nlist</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_rmdir</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_rmdir</function> efface le dossier <parameter>directory</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-nlist"> + <refnamediv> + <refname>ftp_nlist</refname> + <refpurpose>Retourne la liste des fichiers dans un dossier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>ftp_nlist</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>directory</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_nlist</function> retourne un tableau de nom de fichiers en cas - de succès, et &false; sinon. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-rawlist"> - <refnamediv> - <refname>ftp_rawlist</refname> - <refpurpose> - Fait une liste détaillée de fichier dans un dossier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_rawlist</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_nlist</function> retourne un tableau de nom de fichiers en cas + de succès, et <literal>FALSE</literal> sinon. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-rawlist"> + <refnamediv> + <refname>ftp_rawlist</refname> + <refpurpose> + Fait une liste détaillée de fichiers dans un dossier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>ftp_rawlist</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>directory</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_rawlist</function> exécute la commande FTP LIST, et - retourne le résultat dans un tableau. Chaque élément - du tableau correspond à une ligne du résultat de la commande. - Le résultat n'est pas analysé, et est retourné brut. - L'identifiant de système retourné par - <function>ftp_systype</function> sera utile pour déterminer - la façon d'interpréter le résutltat. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-systype"> - <refnamediv> - <refname>ftp_systype</refname> - <refpurpose> - Retourne un identifiant de type de serveur FTP. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_systype</function></funcdef> - <paramdef>resource <parameter>ftp_stream</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_systype</function> retourne le type de serveur, - ou &false; en cas d'erreur. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-pasv"> - <refnamediv> - <refname>ftp_pasv</refname> - <refpurpose>Active ou désactive le mode passif.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_pasv</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_rawlist</function> exécute la commande FTP LIST, et + retourne le résultat dans un tableau. Chaque élément + du tableau correspond à une ligne du résultat de la commande. + Le résultat n'est pas analysé, et est retourné brut. + L'identifiant de système retourné par + <function>ftp_systype</function> sera utile pour déterminer + la façon d'interpréter le résultat. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-systype"> + <refnamediv> + <refname>ftp_systype</refname> + <refpurpose> + Retourne un identifiant de type de serveur FTP. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ftp_systype</function></funcdef> + <paramdef>resource <parameter>ftp_stream</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_systype</function> retourne le type de serveur, + ou <literal>FALSE</literal> en cas d'erreur. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-pasv"> + <refnamediv> + <refname>ftp_pasv</refname> + <refpurpose>Active ou désactive le mode passif.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_pasv</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>int <parameter>pasv</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_pasv</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_pasv</function> active le mode passif si - <parameter>pasv</parameter> est à &true; - (et le désactive si <parameter>pasv</parameter> est à - &false;). En mode passif, les données de connexion - sont initiées par le client, plutôt que par le serveur. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-get"> - <refnamediv> - <refname>ftp_get</refname> - <refpurpose> - Télécharge un fichier depuis un serveur FTP. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_get</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_pasv</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_pasv</function> active le mode passif si + <parameter>pasv</parameter> est à <literal>TRUE</literal> + (et le désactive si <parameter>pasv</parameter> est à + <literal>FALSE</literal>). En mode passif, les données de connexion + sont initiées par le client, plutôt que par le serveur. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-get"> + <refnamediv> + <refname>ftp_get</refname> + <refpurpose> + Télécharge un fichier depuis un serveur FTP. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_get</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>local_file</parameter></paramdef> <paramdef>string <parameter>remote_file</parameter></paramdef> <paramdef>int <parameter>mode</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_get</function> retourne &true; en cas - de succès, et &false; sinon. - </para> - <para> - <function>ftp_get</function> télécharge le fichier - <parameter>remote_file</parameter> depuis le serveur FTP, et le sauve dans le - fichier local <parameter>local_file</parameter>. Le mode de transfert - <parameter>mode</parameter> spécifié doit être soit FTP_ASCII - ou FTP_BINARY. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-fget"> - <refnamediv> - <refname>ftp_fget</refname> - <refpurpose> - Télécharge un fichier depuis un serveur FTP et le sauve - dans un fichier déjà ouvert. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_fget</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_get</function> retourne <literal>TRUE</literal> en cas + de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_get</function> télécharge le fichier + <parameter>remote_file</parameter> depuis le serveur FTP, et le sauve dans le + fichier local <parameter>local_file</parameter>. Le mode de transfert + <parameter>mode</parameter> spécifié doit être soit FTP_ASCII + ou FTP_BINARY. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-fget"> + <refnamediv> + <refname>ftp_fget</refname> + <refpurpose> + Télécharge un fichier depuis un serveur FTP et le sauve + dans un fichier déjà ouvert. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_fget</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>int <parameter>fp</parameter></paramdef> <paramdef>string <parameter>remote_file</parameter></paramdef> <paramdef>int <parameter>mode</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_fget</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_fget</function> télécharge le fichier - <parameter>remote_file</parameter> depuis le serveur FTP, et l'écrit - dans le fichier identifié par <parameter>fp</parameter>. Le mode de - transfert <parameter>mode</parameter> spécifié doit être - FTP_ASCII ou FTP_BINARY. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-put"> - <refnamediv> - <refname>ftp_put</refname> - <refpurpose>Charge un fichier sur un serveur FTP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_put</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_fget</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_fget</function> télécharge le fichier + <parameter>remote_file</parameter> depuis le serveur FTP, et l'écrit + dans le fichier identifié par <parameter>fp</parameter>. Le mode de + transfert <parameter>mode</parameter> spécifié doit être + FTP_ASCII ou FTP_BINARY. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-put"> + <refnamediv> + <refname>ftp_put</refname> + <refpurpose>Charge un fichier sur un serveur FTP.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_put</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>remote_file</parameter></paramdef> <paramdef>string <parameter>local_file</parameter></paramdef> <paramdef>int <parameter>mode</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_put</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_put</function> enregistre le fichier - <parameter>local_file</parameter> sur le serveur FTP, sous le nom de - <parameter>remote_file</parameter>. Le mode de transfert - <parameter>mode</parameter> spécifié doit être - <literal>FTP_ASCII</literal> ou <literal>FTP_BINARY</literal>. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-fput"> - <refnamediv> - <refname>ftp_fput</refname> - <refpurpose>Charge un fichier ouvert sur un serveur FTP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_fput</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_put</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_put</function> enregistre le fichier + <parameter>local_file</parameter> sur le serveur FTP, sous le nom de + <parameter>remote_file</parameter>. Le mode de transfert + <parameter>mode</parameter> spécifié doit être + <literal>FTP_ASCII</literal> ou <literal>FTP_BINARY</literal>. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-fput"> + <refnamediv> + <refname>ftp_fput</refname> + <refpurpose>Charge un fichier ouvert sur un serveur FTP.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_fput</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>remote_file</parameter></paramdef> <paramdef>int <parameter>fp</parameter></paramdef> <paramdef>int <parameter>mode</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_fput</function> retourne &true; - en cas de succès, et FALSEsinon. - </para> - <para> - <function>ftp_fput</function> charge les données issues du fichier - identifié par <parameter>fp</parameter> jusqu'à la fin du fichier. - Le résultat est stocké dans le fichier - <parameter>remote_file</parameter> sur le serveur FTP. Le mode de transfert - <parameter>mode</parameter> spécifié doit être - FTP_ASCII ou FTP_BINARY. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-size"> - <refnamediv> - <refname>ftp_size</refname> - <refpurpose> - Retourne la taille d'un fichier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_fput</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_fput</function> charge les données issues du fichier + identifié par <parameter>fp</parameter> jusqu'à la fin du fichier. + Le résultat est stocké dans le fichier + <parameter>remote_file</parameter> sur le serveur FTP. Le mode de transfert + <parameter>mode</parameter> spécifié doit être + FTP_ASCII ou FTP_BINARY. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-size"> + <refnamediv> + <refname>ftp_size</refname> + <refpurpose> + Retourne la taille d'un fichier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>ftp_size</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>remote_file</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_size</function> retourne la taille du fichier en - cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_size</function> retourne la taille d'un fichier sur un serveur FTP. - Si une erreur survient, ou que le ficheir n'existe pas, la valeur -1 est - retournée. Certains serveurs FTP ne supportent pas cette fonction. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-mdtm"> - <refnamediv> - <refname>ftp_mdtm</refname> - <refpurpose> - Retourne la date de dernière modification d'un fichier sur - un serveur FTP. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_size</function> retourne la taille du fichier en + cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_size</function> retourne la taille d'un fichier sur un serveur FTP. + Si une erreur survient, ou que le fichier n'existe pas, la valeur -1 est + retournée. Certains serveurs FTP ne supportent pas cette fonction. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-mdtm"> + <refnamediv> + <refname>ftp_mdtm</refname> + <refpurpose> + Retourne la date de dernière modification d'un fichier sur + un serveur FTP. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>ftp_mdtm</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>remote_file</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_mdtm</function> retourne un UNIX timestamp en cas de - succès, et FALSEsinon. - </para> - <para> - <function>ftp_mdtm</function> lit la date de dernière modification - d'un fichier et retourne le UNIX timestamp. Si une erreur survient, ou si - le fichier n'existe pas,la valeur -1 est retournée. Certains serveurs - FTP ne supportent pas cette fonction. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-rename"> - <refnamediv> - <refname>ftp_rename</refname> - <refpurpose>Renomme un fichier sur un serveur FTP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_rename</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_mdtm</function> retourne un UNIX timestamp en cas de + succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_mdtm</function> lit la date de dernière modification + d'un fichier et retourne le UNIX timestamp. Si une erreur survient, ou si + le fichier n'existe pas,la valeur -1 est retournée. Certains serveurs + FTP ne supportent pas cette fonction. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-rename"> + <refnamediv> + <refname>ftp_rename</refname> + <refpurpose>Renomme un fichier sur un serveur FTP.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_rename</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>from</parameter></paramdef> <paramdef>string <parameter>to</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_rename</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_rename</function> renomme le fichier <parameter>from</parameter> - en <parameter>to</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-delete"> - <refnamediv> - <refname>ftp_delete</refname> - <refpurpose>Efface un fichier sur un serveur FTP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_delete</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_rename</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_rename</function> renomme le fichier ou dossier + <parameter>from</parameter> en <parameter>to</parameter>, + sur le serveur <parameter>ftp_stream</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-delete"> + <refnamediv> + <refname>ftp_delete</refname> + <refpurpose>Efface un fichier sur un serveur FTP.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_delete</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>path</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_delete</function> retourne &true; - en cas de succès, et FALSEsinon. - </para> - <para> - <function>ftp_delete</function> efface le fichier <parameter>path</parameter> - sur un serveur FTP. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-site"> - <refnamediv> - <refname>ftp_site</refname> - <refpurpose>Envoie la commande SITE au serveur.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_site</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_delete</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_delete</function> efface le fichier <parameter>path</parameter> + sur un serveur FTP. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-site"> + <refnamediv> + <refname>ftp_site</refname> + <refpurpose>Envoie la commande SITE au serveur.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_site</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>cmd</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_site</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_site</function> envoie la commande <parameter>cmd</parameter> au - serveur FTP. Les commandes SITE ne sont pas normalisées, et peuvent - varier d'un serveur à l'autre. Elles permettent de gérer - notamment les permissions de fichier, et les groupes. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-quit"> - <refnamediv> - <refname>ftp_quit</refname> - <refpurpose>Ferme une connexion FTP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_quit</function></funcdef> - <paramdef>resource <parameter>ftp_stream</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_connect</function> ferme la connexion - <parameter>ftp_stream</parameter>. - </para> - </refsect1> - </refentry> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_site</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_site</function> envoie la commande <parameter>cmd</parameter> au + serveur FTP. Les commandes SITE ne sont pas normalisées, et peuvent + varier d'un serveur à l'autre. Elles permettent de gérer + notamment les permissions de fichier, et les groupes. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-quit"> + <refnamediv> + <refname>ftp_quit</refname> + <refpurpose>Ferme une connexion FTP.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_quit</function></funcdef> + <paramdef>resource <parameter>ftp_stream</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_connect</function> ferme la connexion + <parameter>ftp_stream</parameter>. + </para> + </refsect1> + </refentry> </reference> <!-- Keep this comment at the end of the file Local variables:
Index: phpdoc/fr/functions/ftp.xml diff -u phpdoc/fr/functions/ftp.xml:1.6 phpdoc/fr/functions/ftp.xml:1.7 --- phpdoc/fr/functions/ftp.xml:1.6 Sat Jul 7 18:22:08 2001 +++ phpdoc/fr/functions/ftp.xml Tue Jul 17 12:06:31 2001 @@ -1,20 +1,22 @@ - <reference id="ref.ftp"> - <title>FTP</title> - <titleabbrev>FTP</titleabbrev> - <partintro> - <para> - FTP : File Transfer Protocol (Protocole de transfert de fichiers). - </para> - <para> - Les constantes suivantes sont définies dans le module FTP : - <constant>FTP_ASCII</constant> et <constant>FTP_BINARY</constant>. - </para> +<reference id="ref.ftp"> + <title>FTP</title> + <titleabbrev>FTP</titleabbrev> + <partintro> + <para> + FTP : File Transfer Protocol (Protocole de transfert de fichiers). + Ces fonctions implémentent un client pour accéder aux serveurs FTP, + comme défini dans &spec.ftp;. + </para> + <para> + Les constantes suivantes sont définies dans le module FTP : + <constant>FTP_ASCII</constant> et <constant>FTP_BINARY</constant>. + </para> <para> - <example> - <title>Exemple de connexion FTP</title> - <programlisting role="php"> + <example> + <title>Exemple de connexion FTP</title> + <programlisting role="php"> <?php -// création de la connection +// création de la connexion $conn_id = ftp_connect("$ftp_server"); // authentification avec nom de compte et mot de passe $login_result = ftp_login($conn_id, "$ftp_user_name", "$ftp_user_pass"); @@ -37,497 +39,541 @@ // fermeture de la connexion FTP. ftp_quit($conn_id); ?> - </programlisting> - </example> - </para> </partintro> - <refentry id="function.ftp-connect"> - <refnamediv> - <refname>ftp_connect</refname> - <refpurpose>Ouvre une connexion FTP</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </example> + </para> + </partintro> + <refentry id="function.ftp-connect"> + <refnamediv> + <refname>ftp_connect</refname> + <refpurpose>Ouvre une connexion FTP</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>resource <function>ftp_connect</function></funcdef> <paramdef>string <parameter>host</parameter></paramdef> <paramdef>int <parameter><optional>port</optional> - </parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_connect</function> retourne un flot <acronym>FTP</acronym> - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_connect</function> ouvre une connexion FTP avec l'hôte - <parameter>host</parameter>. Le paramètre <parameter>port</parameter> - spécifie le port de connexion. Si il est omis, le port 21 sera - utilisé. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-login"> - <refnamediv> - <refname>ftp_login</refname> - <refpurpose>Authentification d'une connexion FTP</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_login</function></funcdef> + </parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_connect</function> retourne un flot <acronym>FTP</acronym> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_connect</function> ouvre une connexion FTP avec l'hôte + <parameter>host</parameter>. Le paramètre <parameter>port</parameter> + spécifie le port de connexion. S'il est omis, le port 21 sera + utilisé. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-login"> + <refnamediv> + <refname>ftp_login</refname> + <refpurpose>Authentification d'une connexion FTP</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_login</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>username</parameter></paramdef> <paramdef>string <parameter>password</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_login</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_login</function> authentifie le flot FTP. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-pwd"> - <refnamediv> - <refname>ftp_pwd</refname> - <refpurpose>Retourne le nom du dossier courant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_pwd</function></funcdef> - <paramdef>resource <parameter>ftp_stream</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_pwd</function> retourne le nom du dossier courant, - ou &false; en cas d'erreur. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-cdup"> - <refnamediv> - <refname>ftp_cdup</refname> - <refpurpose>Change de dossier, et passe au dossier parent.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_cdup</function></funcdef> - <paramdef>resource <parameter>ftp_stream</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_cdup</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_cdup</function> change de dossier, et passe au dossier parent. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-chdir"> - <refnamediv> - <refname>ftp_chdir</refname> - <refpurpose>Change le dossier courant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_chdir</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_login</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_login</function> authentifie le flot FTP. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-pwd"> + <refnamediv> + <refname>ftp_pwd</refname> + <refpurpose>Retourne le nom du dossier courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ftp_pwd</function></funcdef> + <paramdef>resource <parameter>ftp_stream</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_pwd</function> retourne le nom du dossier courant, + ou <literal>FALSE</literal> en cas d'erreur. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-cdup"> + <refnamediv> + <refname>ftp_cdup</refname> + <refpurpose>Change de dossier, et passe au dossier parent.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_cdup</function></funcdef> + <paramdef>resource <parameter>ftp_stream</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_cdup</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_cdup</function> change de dossier, et passe au dossier parent. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-chdir"> + <refnamediv> + <refname>ftp_chdir</refname> + <refpurpose>Change le dossier courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_chdir</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>directory</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_chdir</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_chdir</function> change le dossier courant en - <parameter>directory</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-mkdir"> - <refnamediv> - <refname>ftp_mkdir</refname> - <refpurpose>Crée un dossier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_chdir</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_chdir</function> change le dossier courant en + <parameter>directory</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-mkdir"> + <refnamediv> + <refname>ftp_mkdir</refname> + <refpurpose>Crée un dossier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>ftp_mkdir</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>directory</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_mkdir</function> retourne le nom du dossier ainsi créé - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_mkdir</function> crée le dossier nommé - <parameter>directory</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-rmdir"> - <refnamediv> - <refname>ftp_rmdir</refname> - <refpurpose>Efface un dossier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_rmdir</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_mkdir</function> retourne le nom du dossier ainsi créé + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_mkdir</function> crée le dossier nommé + <parameter>directory</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-rmdir"> + <refnamediv> + <refname>ftp_rmdir</refname> + <refpurpose>Efface un dossier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_rmdir</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>directory</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_rmdir</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_rmdir</function> efface le dossier <parameter>directory</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-nlist"> - <refnamediv> - <refname>ftp_nlist</refname> - <refpurpose>Retourne la liste des fichiers dans un dossier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_nlist</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_rmdir</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_rmdir</function> efface le dossier <parameter>directory</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-nlist"> + <refnamediv> + <refname>ftp_nlist</refname> + <refpurpose>Retourne la liste des fichiers dans un dossier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>ftp_nlist</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>directory</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_nlist</function> retourne un tableau de nom de fichiers en cas - de succès, et &false; sinon. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-rawlist"> - <refnamediv> - <refname>ftp_rawlist</refname> - <refpurpose> - Fait une liste détaillée de fichier dans un dossier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_rawlist</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_nlist</function> retourne un tableau de nom de fichiers en cas + de succès, et <literal>FALSE</literal> sinon. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-rawlist"> + <refnamediv> + <refname>ftp_rawlist</refname> + <refpurpose> + Fait une liste détaillée de fichiers dans un dossier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>ftp_rawlist</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>directory</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_rawlist</function> exécute la commande FTP LIST, et - retourne le résultat dans un tableau. Chaque élément - du tableau correspond à une ligne du résultat de la commande. - Le résultat n'est pas analysé, et est retourné brut. - L'identifiant de système retourné par - <function>ftp_systype</function> sera utile pour déterminer - la façon d'interpréter le résutltat. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-systype"> - <refnamediv> - <refname>ftp_systype</refname> - <refpurpose> - Retourne un identifiant de type de serveur FTP. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_systype</function></funcdef> - <paramdef>resource <parameter>ftp_stream</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_systype</function> retourne le type de serveur, - ou &false; en cas d'erreur. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-pasv"> - <refnamediv> - <refname>ftp_pasv</refname> - <refpurpose>Active ou désactive le mode passif.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_pasv</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_rawlist</function> exécute la commande FTP LIST, et + retourne le résultat dans un tableau. Chaque élément + du tableau correspond à une ligne du résultat de la commande. + Le résultat n'est pas analysé, et est retourné brut. + L'identifiant de système retourné par + <function>ftp_systype</function> sera utile pour déterminer + la façon d'interpréter le résultat. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-systype"> + <refnamediv> + <refname>ftp_systype</refname> + <refpurpose> + Retourne un identifiant de type de serveur FTP. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ftp_systype</function></funcdef> + <paramdef>resource <parameter>ftp_stream</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_systype</function> retourne le type de serveur, + ou <literal>FALSE</literal> en cas d'erreur. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-pasv"> + <refnamediv> + <refname>ftp_pasv</refname> + <refpurpose>Active ou désactive le mode passif.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_pasv</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>int <parameter>pasv</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_pasv</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_pasv</function> active le mode passif si - <parameter>pasv</parameter> est à &true; - (et le désactive si <parameter>pasv</parameter> est à - &false;). En mode passif, les données de connexion - sont initiées par le client, plutôt que par le serveur. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-get"> - <refnamediv> - <refname>ftp_get</refname> - <refpurpose> - Télécharge un fichier depuis un serveur FTP. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_get</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_pasv</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_pasv</function> active le mode passif si + <parameter>pasv</parameter> est à <literal>TRUE</literal> + (et le désactive si <parameter>pasv</parameter> est à + <literal>FALSE</literal>). En mode passif, les données de connexion + sont initiées par le client, plutôt que par le serveur. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-get"> + <refnamediv> + <refname>ftp_get</refname> + <refpurpose> + Télécharge un fichier depuis un serveur FTP. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_get</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>local_file</parameter></paramdef> <paramdef>string <parameter>remote_file</parameter></paramdef> <paramdef>int <parameter>mode</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_get</function> retourne &true; en cas - de succès, et &false; sinon. - </para> - <para> - <function>ftp_get</function> télécharge le fichier - <parameter>remote_file</parameter> depuis le serveur FTP, et le sauve dans le - fichier local <parameter>local_file</parameter>. Le mode de transfert - <parameter>mode</parameter> spécifié doit être soit FTP_ASCII - ou FTP_BINARY. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-fget"> - <refnamediv> - <refname>ftp_fget</refname> - <refpurpose> - Télécharge un fichier depuis un serveur FTP et le sauve - dans un fichier déjà ouvert. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_fget</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_get</function> retourne <literal>TRUE</literal> en cas + de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_get</function> télécharge le fichier + <parameter>remote_file</parameter> depuis le serveur FTP, et le sauve dans le + fichier local <parameter>local_file</parameter>. Le mode de transfert + <parameter>mode</parameter> spécifié doit être soit FTP_ASCII + ou FTP_BINARY. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-fget"> + <refnamediv> + <refname>ftp_fget</refname> + <refpurpose> + Télécharge un fichier depuis un serveur FTP et le sauve + dans un fichier déjà ouvert. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_fget</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>int <parameter>fp</parameter></paramdef> <paramdef>string <parameter>remote_file</parameter></paramdef> <paramdef>int <parameter>mode</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_fget</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_fget</function> télécharge le fichier - <parameter>remote_file</parameter> depuis le serveur FTP, et l'écrit - dans le fichier identifié par <parameter>fp</parameter>. Le mode de - transfert <parameter>mode</parameter> spécifié doit être - FTP_ASCII ou FTP_BINARY. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-put"> - <refnamediv> - <refname>ftp_put</refname> - <refpurpose>Charge un fichier sur un serveur FTP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_put</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_fget</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_fget</function> télécharge le fichier + <parameter>remote_file</parameter> depuis le serveur FTP, et l'écrit + dans le fichier identifié par <parameter>fp</parameter>. Le mode de + transfert <parameter>mode</parameter> spécifié doit être + FTP_ASCII ou FTP_BINARY. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-put"> + <refnamediv> + <refname>ftp_put</refname> + <refpurpose>Charge un fichier sur un serveur FTP.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_put</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>remote_file</parameter></paramdef> <paramdef>string <parameter>local_file</parameter></paramdef> <paramdef>int <parameter>mode</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_put</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_put</function> enregistre le fichier - <parameter>local_file</parameter> sur le serveur FTP, sous le nom de - <parameter>remote_file</parameter>. Le mode de transfert - <parameter>mode</parameter> spécifié doit être - <literal>FTP_ASCII</literal> ou <literal>FTP_BINARY</literal>. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-fput"> - <refnamediv> - <refname>ftp_fput</refname> - <refpurpose>Charge un fichier ouvert sur un serveur FTP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_fput</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_put</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_put</function> enregistre le fichier + <parameter>local_file</parameter> sur le serveur FTP, sous le nom de + <parameter>remote_file</parameter>. Le mode de transfert + <parameter>mode</parameter> spécifié doit être + <literal>FTP_ASCII</literal> ou <literal>FTP_BINARY</literal>. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-fput"> + <refnamediv> + <refname>ftp_fput</refname> + <refpurpose>Charge un fichier ouvert sur un serveur FTP.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_fput</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>remote_file</parameter></paramdef> <paramdef>int <parameter>fp</parameter></paramdef> <paramdef>int <parameter>mode</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_fput</function> retourne &true; - en cas de succès, et FALSEsinon. - </para> - <para> - <function>ftp_fput</function> charge les données issues du fichier - identifié par <parameter>fp</parameter> jusqu'à la fin du fichier. - Le résultat est stocké dans le fichier - <parameter>remote_file</parameter> sur le serveur FTP. Le mode de transfert - <parameter>mode</parameter> spécifié doit être - FTP_ASCII ou FTP_BINARY. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-size"> - <refnamediv> - <refname>ftp_size</refname> - <refpurpose> - Retourne la taille d'un fichier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_fput</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_fput</function> charge les données issues du fichier + identifié par <parameter>fp</parameter> jusqu'à la fin du fichier. + Le résultat est stocké dans le fichier + <parameter>remote_file</parameter> sur le serveur FTP. Le mode de transfert + <parameter>mode</parameter> spécifié doit être + FTP_ASCII ou FTP_BINARY. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-size"> + <refnamediv> + <refname>ftp_size</refname> + <refpurpose> + Retourne la taille d'un fichier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>ftp_size</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>remote_file</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_size</function> retourne la taille du fichier en - cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_size</function> retourne la taille d'un fichier sur un serveur FTP. - Si une erreur survient, ou que le ficheir n'existe pas, la valeur -1 est - retournée. Certains serveurs FTP ne supportent pas cette fonction. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-mdtm"> - <refnamediv> - <refname>ftp_mdtm</refname> - <refpurpose> - Retourne la date de dernière modification d'un fichier sur - un serveur FTP. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_size</function> retourne la taille du fichier en + cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_size</function> retourne la taille d'un fichier sur un serveur FTP. + Si une erreur survient, ou que le fichier n'existe pas, la valeur -1 est + retournée. Certains serveurs FTP ne supportent pas cette fonction. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-mdtm"> + <refnamediv> + <refname>ftp_mdtm</refname> + <refpurpose> + Retourne la date de dernière modification d'un fichier sur + un serveur FTP. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>ftp_mdtm</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>remote_file</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_mdtm</function> retourne un UNIX timestamp en cas de - succès, et FALSEsinon. - </para> - <para> - <function>ftp_mdtm</function> lit la date de dernière modification - d'un fichier et retourne le UNIX timestamp. Si une erreur survient, ou si - le fichier n'existe pas,la valeur -1 est retournée. Certains serveurs - FTP ne supportent pas cette fonction. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-rename"> - <refnamediv> - <refname>ftp_rename</refname> - <refpurpose>Renomme un fichier sur un serveur FTP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_rename</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_mdtm</function> retourne un UNIX timestamp en cas de + succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_mdtm</function> lit la date de dernière modification + d'un fichier et retourne le UNIX timestamp. Si une erreur survient, ou si + le fichier n'existe pas,la valeur -1 est retournée. Certains serveurs + FTP ne supportent pas cette fonction. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-rename"> + <refnamediv> + <refname>ftp_rename</refname> + <refpurpose>Renomme un fichier sur un serveur FTP.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_rename</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>from</parameter></paramdef> <paramdef>string <parameter>to</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_rename</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_rename</function> renomme le fichier <parameter>from</parameter> - en <parameter>to</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-delete"> - <refnamediv> - <refname>ftp_delete</refname> - <refpurpose>Efface un fichier sur un serveur FTP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_delete</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_rename</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_rename</function> renomme le fichier ou dossier + <parameter>from</parameter> en <parameter>to</parameter>, + sur le serveur <parameter>ftp_stream</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-delete"> + <refnamediv> + <refname>ftp_delete</refname> + <refpurpose>Efface un fichier sur un serveur FTP.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_delete</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>path</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_delete</function> retourne &true; - en cas de succès, et FALSEsinon. - </para> - <para> - <function>ftp_delete</function> efface le fichier <parameter>path</parameter> - sur un serveur FTP. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-site"> - <refnamediv> - <refname>ftp_site</refname> - <refpurpose>Envoie la commande SITE au serveur.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_site</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_delete</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_delete</function> efface le fichier <parameter>path</parameter> + sur un serveur FTP. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-site"> + <refnamediv> + <refname>ftp_site</refname> + <refpurpose>Envoie la commande SITE au serveur.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_site</function></funcdef> <paramdef>resource <parameter>ftp_stream</parameter></paramdef> <paramdef>string <parameter>cmd</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_site</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <function>ftp_site</function> envoie la commande <parameter>cmd</parameter> au - serveur FTP. Les commandes SITE ne sont pas normalisées, et peuvent - varier d'un serveur à l'autre. Elles permettent de gérer - notamment les permissions de fichier, et les groupes. - </para> - </refsect1> - </refentry> - <refentry id="function.ftp-quit"> - <refnamediv> - <refname>ftp_quit</refname> - <refpurpose>Ferme une connexion FTP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ftp_quit</function></funcdef> - <paramdef>resource <parameter>ftp_stream</parameter></paramdef> - </funcsynopsis> - <para> - <function>ftp_connect</function> ferme la connexion - <parameter>ftp_stream</parameter>. - </para> - </refsect1> - </refentry> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_site</function> retourne <literal>TRUE</literal> + en cas de succès, et <literal>FALSE</literal> sinon. + </para> + <para> + <function>ftp_site</function> envoie la commande <parameter>cmd</parameter> au + serveur FTP. Les commandes SITE ne sont pas normalisées, et peuvent + varier d'un serveur à l'autre. Elles permettent de gérer + notamment les permissions de fichier, et les groupes. + </para> + </refsect1> + </refentry> + <refentry id="function.ftp-quit"> + <refnamediv> + <refname>ftp_quit</refname> + <refpurpose>Ferme une connexion FTP.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>ftp_quit</function></funcdef> + <paramdef>resource <parameter>ftp_stream</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftp_connect</function> ferme la connexion + <parameter>ftp_stream</parameter>. + </para> + </refsect1> + </refentry> </reference> <!-- Keep this comment at the end of the file Local variables: