Index: phpdoc/fr/functions/ftp.xml
diff -u phpdoc/fr/functions/ftp.xml:1.1 phpdoc/fr/functions/ftp.xml:1.2
--- phpdoc/fr/functions/ftp.xml:1.1 Fri Jul 21 03:27:50 2000
+++ phpdoc/fr/functions/ftp.xml Mon Oct 30 05:32:44 2000
@@ -1,493 +1,545 @@
-
- FTP
- FTP
-
-
-
- FTP : File Transfer Protocol.
-
-
- Les constantes suivantes sont définies dans le module FTP :
-
- FTP_ASCII, et
- FTP_BINARY.
-
-
-
-
-
- ftp_connect
- Ouvre une connexion FTP
-
-
- Description
-
- int ftp_connect
- string host
- int port
-
-
-
- Retourne un flot FTP en cas de succès, et FALSEsinon.
-
- ftp_connect ouvre une connexion FTP avec l'hôte
- host. Le paramètre port
- spécifie le port de connexion. Si il est omis, le port 21 sera utilisé.
-
-
-
-
-
-
-
- ftp_login
- Authentification d'une connexion FTP
-
-
- Description
-
- int ftp_login
- int ftp_stream
- string username
- string password
-
-
- Retourne TRUE en cas de succès, et FALSE sinon.
-
-
- Authentifie le flot FTP.
-
-
-
-
-
-
- ftp_pwd
- Retourne le nom du dossier courant.
-
-
- Description
-
- int ftp_pwd
- int ftp_stream
-
-
- Retourne le nom du dossier courant, ou FALSE en cas d'erreur.
-
-
-
-
-
- ftp_cdup
- Change de dossier, et passe au dossier parent.
-
-
- Description
-
- int ftp_cdup
- int ftp_stream
-
-
- Retourne TRUE en cas de succès, et FALSE sinon.
-
-
- Change de dossier, et passe au dossier parent.
-
-
-
-
-
-
- ftp_chdir
- Change le dossier courant.
-
-
- Description
-
- int ftp_chdir
- int ftp_stream
- string directory
-
-
- Retourne TRUE en cas de succès, et FALSE sinon.
-
-
- Change le dossier courant en directory.
-
-
-
-
-
-
- ftp_mkdir
- Crée un dossier.
-
-
- Description
-
- string ftp_mkdir
- int ftp_stream
- string directory
-
-
- Retourne le nom du dossier ainsi créé en cas de succès, et FALSE sinon.
-
-
- Crée le dossier nommé directory.
-
-
-
-
-
-
- ftp_rmdir
- Efface un dossier.
-
-
- Description
-
- int ftp_rmdir
- int ftp_stream
- string directory
-
-
- Retourne TRUE en cas de succès, et FALSE sinon.
-
-
- Efface le dossier directory.
-
-
-
-
-
-
- ftp_nlist
- Retourne la liste des fichiers dans un dossier.
-
-
- Description
-
- int ftp_nlist
- int ftp_stream
- string directory
-
-
- Retourne un tableau de nom de fichiers en cas de succès, et FALSE sinon.
-
-
-
-
-
-
- ftp_rawlist
-
-Fait une liste détaillée de fichier dans un dossier.
-
-
-
- Description
-
- int ftp_rawlist
- int ftp_stream
- string directory
-
-
- ftp_rawlist 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 ftp_systype sera utile
- pour déterminer la façon d'interpréter le résutltat.
-
-
-
-
-
-
- ftp_systype
-
- Retourne un identifiant de type de serveur FTP.
-
-
-
- Description
-
- int ftp_systype
- int ftp_stream
-
-
- Retourne le type de serveur, ou FALSE en cas d'erreur.
-
-
-
-
-
- ftp_pasv
- Active ou désactive le mode passif.
-
-
- Description
-
- int ftp_pasv
- int ftp_stream
- int pasv
-
-
- Retourne TRUE en cas de succès, et FALSE sinon.
-
- ftp_pasv active le mode passif si pasv
- est à TRUE (et le désactive si pasv est à FALSE.)
- En mode passif, les données de connexion sont initiées par le client, plutôt
- que par le serveur.
-
-
-
-
-
-
- ftp_get
- Télécharge un fichier depuis un serveur FTP.
-
-
- Description
-
- int ftp_get
- int ftp_stream
- string local_file
- string remote_file
- int mode
-
-
- Retourne TRUE en cas de succès, et FALSE sinon.
-
-
- ftp_get télécharge le fichier
- remote_file depuis le serveur FTP, et le sauve dans le
- fichier local local_file. Le mode de transfert
- mode spécifié doit être soit FTP_ASCII ou FTP_BINARY.
-
-
-
-
-
-
- ftp_fget
- Télécharge un fichier depuis un serveur FTP et le sauve dans un fichier déjà ouvert.
-
-
- Description
-
- int ftp_fget
- int ftp_stream
- int fp
- string remote_file
- int mode
-
-
- Retourne TRUE en cas de succès, et FALSE sinon.
-
- ftp_fget télécharge le fichier remote_file
- depuis le serveur FTP, et l'écrit dans le fichier identifié par
- fp. Le mode de transfert mode
- spécifié doit être FTP_ASCII ou FTP_BINARY.
-
-
-
-
-
-
- ftp_put
- Charge un fichier sur un serveur FTP.
-
-
- Description
-
- int ftp_put
- int ftp_stream
- string remote_file
- string local_file
- int mode
-
-
- Retourne TRUE en cas de succès, et FALSE sinon.
-
- ftp_put enregistre le fichier local_file
- sur le serveur FTP, sous le nom de remote_file.
- Le mode de transfert mode spécifié doit être
- FTP_ASCII ou FTP_BINARY.
-
-
-
-
-
-
- ftp_fput
- Charge un fichier ouvert sur un serveur FTP.
-
-
- Description
-
- int ftp_fput
- int ftp_stream
- string remote_file
- int fp
- int mode
-
-
- Retourne TRUE en cas de succès, et FALSEsinon.
-
- ftp_fput charge les données issues du fichier identifié par
- fp jusqu'à la fin du fichier. Le résultat est stocké dans le
- fichier remote_file sur le serveur FTP.
- Le mode de transfert mode spécifié doit être
- FTP_ASCII ou FTP_BINARY.
-
-
-
-
-
-
- ftp_size
- Retourne la taille d'un fichier.
-
-
- Description
-
- int ftp_size
- int ftp_stream
- string remote_file
-
-
- Retourne la taille du fichier en cas de succès, et FALSE sinon.
-
-
- ftp_size 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.
-
-
-
-
-
-
- ftp_mdtm
- Retourne la date de dernière modification d'un fichier sur un serveur FTP.
-
-
- Description
-
- int ftp_mdtm
- int ftp_stream
- string remote_file
-
-
- Retourne un UNIX timestamp en cas de succès, et FALSEsinon.
-
- ftp_mdtm 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.
-
-
-
-
-
-
- ftp_rename
- Renomme un fichier sur un serveur FTP.
-
-
- Description
-
- int ftp_rename
- int ftp_stream
- string from
- string to
-
-
- Retourne TRUE en cas de succès, et FALSE sinon.
-
- ftp_rename renomme le fichier from
- en to.
-
-
-
-
-
-
- ftp_delete
- Efface un fichier sur un serveur FTP.
-
-
- Description
-
- int ftp_delete
- int ftp_stream
- string path
-
-
- Retourne TRUE en cas de succès, et FALSEsinon.
-
- ftp_delete efface le fichier path
- sur un serveur FTP.
-
-
-
-
-
-
- ftp_site
- Envoie la commande SITE au serveur.
-
-
- Description
-
- int ftp_site
- int ftp_stream
- string cmd
-
-
- Retourne TRUE en cas de succès, et FALSE sinon.
-
- ftp_site envoie la commande cmd 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.
-
-
-
-
-
-
- ftp_quit
- Ferme une connexion FTP.
-
-
- Description
-
- int ftp_quit
- int ftp_stream
-
-
- ftp_connect ferme la connexion
- ftp_stream.
-
-
-
-
-
-
+
+ FTP
+ FTP
+
+
+
+ FTP : File Transfer Protocol (Protocole de transfert de fichiers).
+
+
+
+ Les constantes suivantes sont définies dans le module FTP :
+ FTP_ASCII and FTP_BINARY.
+
+
+
+ Exemple de connexion ftp
+
+<?php
+// création de la connection
+$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");
+
+// vérification de la connexion
+if ((!$conn_id) || (!$login_result)) {
+ echo "La connexion FTP a échoué!";
+ echo "Tentative de connexion à $ftp_server avec $user";
+ die;
+ } else {
+ echo "Connecté à $ftp_server, avec $user";
+ }
+
+// téléchargement d'un fichier
+$upload = ftp_put($conn_id, "$destination_file", "$source_file", FTP_BINARY);
+
+// Vérification de téléchargement
+if (!$upload) {
+ echo "Le téléchargement Ftp a échoué!";
+ } else {
+ echo "Téléchargement de $source_file sur $ftp_server en $destination_file";
+ }
+
+// fermeture de la connexion FTP.
+ftp_quit($conn_id);
+?>
+
+
+
+
+
+
+ ftp_connect
+ Ouvre une connexion FTP
+
+
+ Description
+
+ int ftp_connect
+ string host
+ int port
+
+
+
+ Retourne un flot FTP en cas de succès, et FALSEsinon.
+
+ ftp_connect ouvre une connexion FTP avec l'hôte
+ host. Le paramètre port
+ spécifie le port de connexion. Si il est omis, le port 21 sera
+ utilisé.
+
+
+
+
+
+
+
+ ftp_login
+ Authentification d'une connexion FTP
+
+
+ Description
+
+ int ftp_login
+ int ftp_stream
+ string username
+ string password
+
+
+ Retourne TRUE en cas de succès, et FALSE sinon.
+
+
+ Authentifie le flot FTP.
+
+
+
+
+
+
+ ftp_pwd
+ Retourne le nom du dossier courant.
+
+
+ Description
+
+ int ftp_pwd
+ int ftp_stream
+
+
+ Retourne le nom du dossier courant, ou FALSE en cas d'erreur.
+
+
+
+
+
+ ftp_cdup
+ Change de dossier, et passe au dossier parent.
+
+
+ Description
+
+ int ftp_cdup
+ int ftp_stream
+
+
+ Retourne TRUE en cas de succès, et FALSE sinon.
+
+
+ Change de dossier, et passe au dossier parent.
+
+
+
+
+
+
+ ftp_chdir
+ Change le dossier courant.
+
+
+ Description
+
+ int ftp_chdir
+ int ftp_stream
+ string directory
+
+
+ Retourne TRUE en cas de succès, et FALSE sinon.
+
+
+ Change le dossier courant en directory.
+
+
+
+
+
+
+ ftp_mkdir
+ Crée un dossier.
+
+
+ Description
+
+ string ftp_mkdir
+ int ftp_stream
+ string directory
+
+
+ Retourne le nom du dossier ainsi créé en cas de succès,
+ et FALSE sinon.
+
+
+ Crée le dossier nommé directory.
+
+
+
+
+
+
+ ftp_rmdir
+ Efface un dossier.
+
+
+ Description
+
+ int ftp_rmdir
+ int ftp_stream
+ string directory
+
+
+ Retourne TRUE en cas de succès, et FALSE sinon.
+
+
+ Efface le dossier directory.
+
+
+
+
+
+
+ ftp_nlist
+ Retourne la liste des fichiers dans un dossier.
+
+
+ Description
+
+ int ftp_nlist
+ int ftp_stream
+ string directory
+
+
+ Retourne un tableau de nom de fichiers en cas de succès, et FALSE sinon.
+
+
+
+
+
+
+ ftp_rawlist
+
+Fait une liste détaillée de fichier dans un dossier.
+
+
+
+ Description
+
+ int ftp_rawlist
+ int ftp_stream
+ string directory
+
+
+ ftp_rawlist 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
+ ftp_systype sera utile pour déterminer
+ la façon d'interpréter le résutltat.
+
+
+
+
+
+
+ ftp_systype
+
+ Retourne un identifiant de type de serveur FTP.
+
+
+
+ Description
+
+ int ftp_systype
+ int ftp_stream
+
+
+ Retourne le type de serveur, ou FALSE en cas d'erreur.
+
+
+
+
+
+ ftp_pasv
+ Active ou désactive le mode passif.
+
+
+ Description
+
+ int ftp_pasv
+ int ftp_stream
+ int pasv
+
+
+ Retourne TRUE en cas de succès, et FALSE sinon.
+
+ ftp_pasv active le mode passif si pasv
+ est à TRUE (et le désactive si pasv
+ est à FALSE). En mode passif, les données de connexion sont
+ initiées par le client, plutôt que par le serveur.
+
+
+
+
+
+
+ ftp_get
+
+ Télécharge un fichier depuis un serveur FTP.
+
+
+
+ Description
+
+ int ftp_get
+ int ftp_stream
+ string local_file
+ string remote_file
+ int mode
+
+
+ Retourne TRUE en cas de succès, et FALSE sinon.
+
+
+ ftp_get télécharge le fichier
+ remote_file depuis le serveur FTP, et le sauve dans le
+ fichier local local_file. Le mode de transfert
+ mode spécifié doit être soit FTP_ASCII
+ ou FTP_BINARY.
+
+
+
+
+
+
+ ftp_fget
+
+ Télécharge un fichier depuis un serveur FTP et le sauve
+ dans un fichier déjà ouvert.
+
+
+
+ Description
+
+ int ftp_fget
+ int ftp_stream
+ int fp
+ string remote_file
+ int mode
+
+
+ Retourne TRUE en cas de succès, et FALSE sinon.
+
+ ftp_fget télécharge le fichier
+ remote_file depuis le serveur FTP, et l'écrit
+ dans le fichier identifié par fp. Le mode de
+ transfert mode spécifié doit être
+ FTP_ASCII ou FTP_BINARY.
+
+
+
+
+
+
+ ftp_put
+ Charge un fichier sur un serveur FTP.
+
+
+ Description
+
+ int ftp_put
+ int ftp_stream
+ string remote_file
+ string local_file
+ int mode
+
+
+ Retourne TRUE en cas de succès, et FALSE sinon.
+
+ ftp_put enregistre le fichier
+ local_file sur le serveur FTP, sous le nom de
+ remote_file. Le mode de transfert
+ mode spécifié doit être
+ FTP_ASCII ou FTP_BINARY.
+
+
+
+
+
+
+ ftp_fput
+ Charge un fichier ouvert sur un serveur FTP.
+
+
+ Description
+
+ int ftp_fput
+ int ftp_stream
+ string remote_file
+ int fp
+ int mode
+
+
+ Retourne TRUE en cas de succès, et FALSEsinon.
+
+ ftp_fput charge les données issues du fichier
+ identifié par fp jusqu'à la fin du fichier.
+ Le résultat est stocké dans le fichier
+ remote_file sur le serveur FTP. Le mode de transfert
+ mode spécifié doit être
+ FTP_ASCII ou FTP_BINARY.
+
+
+
+
+
+
+ ftp_size
+
+ Retourne la taille d'un fichier.
+
+
+
+ Description
+
+ int ftp_size
+ int ftp_stream
+ string remote_file
+
+
+ Retourne la taille du fichier en cas de succès, et FALSE sinon.
+
+
+ ftp_size 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.
+
+
+
+
+
+
+ ftp_mdtm
+
+ Retourne la date de dernière modification d'un fichier sur
+ un serveur FTP.
+
+
+
+ Description
+
+ int ftp_mdtm
+ int ftp_stream
+ string remote_file
+
+
+ Retourne un UNIX timestamp en cas de succès, et FALSEsinon.
+
+ ftp_mdtm 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.
+
+
+
+
+
+
+ ftp_rename
+ Renomme un fichier sur un serveur FTP.
+
+
+ Description
+
+ int ftp_rename
+ int ftp_stream
+ string from
+ string to
+
+
+ Retourne TRUE en cas de succès, et FALSE sinon.
+
+ ftp_rename renomme le fichier from
+ en to.
+
+
+
+
+
+
+ ftp_delete
+ Efface un fichier sur un serveur FTP.
+
+
+ Description
+
+ int ftp_delete
+ int ftp_stream
+ string path
+
+
+ Retourne TRUE en cas de succès, et FALSEsinon.
+
+ ftp_delete efface le fichier path
+ sur un serveur FTP.
+
+
+
+
+
+
+ ftp_site
+ Envoie la commande SITE au serveur.
+
+
+ Description
+
+ int ftp_site
+ int ftp_stream
+ string cmd
+
+
+ Retourne TRUE en cas de succès, et FALSE sinon.
+
+ ftp_site envoie la commande cmd 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.
+
+
+
+
+
+
+ ftp_quit
+ Ferme une connexion FTP.
+
+
+ Description
+
+ int ftp_quit
+ int ftp_stream
+
+
+ ftp_connect ferme la connexion
+ ftp_stream.
+
+
+
+
+
+