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 <function>ftp</function> + +<?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. + + + + + +