Introduction
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 http://www.faqs.org/rfcs/rfc959.html.
Pré-requis
Ces fonctions sont disponibles dans le module PHP standard, qui est toujours accessible.
Installation
Pour activer le module FTP de votre configuration PHP, il
faut utiliser l'option --enable-ftp en PHP 4, et l'option
--with-ftp en PHP 3 avec le script
de configuration.
La version Windows de PHP dispose du support automatique de cette extension. Vous n'avez pas à ajouter de librairie supplémentaire pour disposer de ces fonctions.
Configuration à l'exécution
Cette extension ne définit aucune directive de configuration.
Types de ressources
This extension uses one resource type, which is the link identifier
of the FTP connection.
Constantes prédefinies
Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.
Les constantes suivantes ont été introduites en PHP 4.3.0.
- FTP_AUTOSEEK
(entier)
Voir ftp_set_option() pour les détails.
- FTP_AUTORESUME
(entier)
Déterimine automatiquement la position de reprise (RESUME) et
la position de début pour les requêtes GET et PUT
(ne fonctionne qu'avec FTP_AUTOSEEK)
- FTP_FAILED
(entier)
Le mode asynchrone a échoué
- FTP_FINISHED
(entier)
Le mode asynchrone a terminé
- FTP_MOREDATA
(entier)
Le mode asynchrone est encore actif
Exemples
Exemple 1. Exemple FTP
<?php
// 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);
// vérification de la connexion
if ((!$conn_id) || (!$login_result)) {
echo "La connexion FTP a échoué!";
echo "Tentative de connexion à $ftp_server avec $ftp_user_name";
die;
} else {
echo "Connected to $ftp_server, for user $ftp_user_name";
}
// 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_close($conn_id);
?>
|
|