ftp_rawlist

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

ftp_rawlist — Возвращает подробный список файлов в заданной директории

Описание

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

ftp_rawlist() отправляет FTP-серверу команду LIST и возвращает результат в виде массива.

Список параметров

ftp: Экземпляр класса FTP\Connection.
directory: Имя директории на сервере. Может включать аргументы для команды LIST.
recursive: Если передано значение true, серверу будет отправлена команда LIST -R.

Возвращаемые значения

Возвращает массив, каждый элемент которого содержит одну строку ответа сервера. Возвращает false, если переданная директория directory не валидна.

Ответ сервера никак не обрабатывается. Для определения того, как следует интерпретировать результат, можно использовать результат работы функции ftp_systype().

Список изменений

Версия	Описание
8.1.0	Параметр `ftp` теперь ожидает экземпляр класса FTP\Connection; раньше параметр ждал ресурс (resource).

Примеры

Пример #1 Пример использования ftp_rawlist()

<?php

// установка соединения
$ftp = ftp_connect($ftp_server);

// проверка имени пользователя и пароля
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

// получение списка файлов директории /
$buff = ftp_rawlist($ftp, '/');

// закрытие соединения
ftp_close($ftp);

// вывод буфера
var_dump($buff);
?>

Вывод приведённого примера будет похож на:

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"
}

Смотрите также

ftp_nlist() - Возвращает список файлов в заданной директории
ftp_mlsd() - Возвращает список файлов в заданной директории