Lancer une commande FTP
Les fonctions ftp_nlist() et ftp_rawlist(), accessible en PHP, envoient une commande 'ls' à un serveur FTP. De la même manière qu'un client FTP classique, la commande liste les fichiers présents dans un dossier avec plus ou moins de précisions.La class FTPDir encapsule les fonctions de communication suivante:
- connect(): connecter au serveur FTP,
- close(): fermer la connexion,
- fixTmpDir(): corriger l'erreur 'open_basedir restriction in effect' sur la commande ftp_nlist() et ftp_rawlist() sur certains serveurs,
- filelist(): lister les noms de fichiers,
- fulllist(): obtenir une liste détaillée des fichiers.
<?php
/**
* Lister les fichiers sur un serveur FTP
* @author fobec.com 2011
*/
class FTPDir {
private $port= 21;
private $timeout=30;
// ID du stream de connexion FTP
private $id;
/**
* Connecter au serveur FTP
* @param string $host adresse du serveur FTP
* @param string $user utilisateur
* @param string $password mot de passe
*/
public function connect($host, $user,$password) {
// ouvrir une connexion au serveur FTP
$this->id = @ftp_connect($host,$this->port,$this->timeout);
if ($this->id===false) {
throw new Exception("Invalid FTP host ");
}
// s'identifier sur le serveur
$login = @ftp_login($this->id, $user, $password);
if ($login===false) {
throw new Exception("Invalid username or password ");
}
// basculer en mode passif
ftp_pasv($this->id, true);
}
/**
* Fermer la connexion au serveur FTP
*/
public function close() {
ftp_close($this->id);
}
/**
* Corriger l'erreur open_basedir restriction in effect
*/
public function fixTmpDir() {
putenv('TMPDIR='.$_SERVER['DOCUMENT_ROOT'].'/temp/');
}
/**
* Lister les fichiers dans le répertoire
* @param string $dir répertoire à lister
* @return array liste de fichiers
*/
public function filelist($dir) {
$files = ftp_nlist($this->id,$dir);
return $files;
}
/**
* Lister les fichiers dans le répertoire
* @param string $dir répertoire à lister
* @return array liste détaillée des fichiers
*/
public function fulllist($dir) {
$files =ftp_rawlist($this->id,$dir);
return $files;
}
}
?>
Lister les images sur un serveur FTP
Utilisons la class FTPDir pour lister les images déposées dans le dossier 'images'.<?php
/**
* Lister les fichiers sur le serveur FTP de monsite.com
*/
$ftpDir=new FTPDir();
//se connecter
$ftpDir->connect('ftp.monsite.com', 'username', 'password');
//corriger l'erreur open_basedir restriction in effect
$ftpDir->fixTmpDir();
//liste détaillé des fichiers dans le dossier image
print_r($ftpDir->filelist('/image'));
//fermer la connexion
$ftpDir->close();
?>
Array
(
[0] => /images/.
[1] => /images/..
[2] => /images/logo.gif
[3] => /images/face.png
...
}