ftp_rawlist

(PHP 4, PHP 5, PHP 7, PHP 8)

ftp_rawlistFait une liste détaillée des fichiers d'un dossier

Description

ftp_rawlist(FTP\Connection $ftp, string $directory, bool $recursive = false): array|false

ftp_rawlist() exécute la commande FTP LIST, et retourne le résultat dans un tableau.

Liste de paramètres

ftp

Une instance de FTP\Connection.

directory

Le chemin vers le dossier. Peut inclure les arguments pour la commande LIST.

recursive

Si défini à true, la commande sera LIST -R.

Valeurs de retour

Retourne un tableau où les éléments correspondent à une ligne de texte. Retourne false lorsque le paramètre directory est invalide.

La sortie n'est jamais analysée. L'identifiant du type système retourné par la fonction ftp_systype() peut être utilisé pour déterminer comment les résultats doivent être interprétés.

Historique

Version Description
8.1.0 La paramètre ftp attend désormais une instance de FTP\Connection ; auparavant, une ressource était attendu.

Exemples

Exemple #1 Exemple avec ftp_rawlist()

<?php

// Mise en place d'une connexion basique
$ftp ftp_connect($ftp_server);

// Identification avec un nom d'utilisateur et un mot de passe
$login_result ftp_login($ftp$ftp_user_name$ftp_user_pass);

// Récupère la liste des fichiers de /
$buff ftp_rawlist($ftp'/');

// Fermeture de la connexion
ftp_close($ftp);

// Affiche le buffer
var_dump($buff);
?>

Résultat de l'exemple ci-dessus est similaire à :

array(3) {
  [0]=>
  string(65) "drwxr-x---   3 vincent  vincent      4096 Jul 12 12:16 public_ftp"
  [1]=>
  string(66) "drwxr-x---  15 vincent  vincent      4096 Nov  3 21:31 public_html"
  [2]=>
  string(73) "lrwxrwxrwx   1 vincent  vincent        11 Jul 12 12:16 www -> public_html"
}

Voir aussi

  • ftp_nlist() - Retourne la liste des fichiers d'un dossier
  • ftp_mlsd() - Retourne la liste des fichiers d'un dossier donné