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

# ftp_nlist

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

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

### Описание

function ftp_nlist(FTP\Connection `$ftp`, string `$directory`): array|false

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

`ftp`
  Экземпляр класса FTP\Connection.
`directory`

  Имя директории для получения списка файлов. Этот параметр также может включать аргументы, например `ftp_nlist($conn_id, "-la /your/dir");`. Обратите внимание, что этот параметр не проходит экранирование спецсимволов, так что могут возникнуть проблемы с именами, содержащими пробелы и прочие подобные символы.

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

Возвращает массив имён файлов в директории или `false` при возникновении ошибки.

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

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

### Примеры

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

    <?php

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

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

    // получить содержимое текущей директории
    $contents = ftp_nlist($ftp, ".");

    // вывод $contents
    var_dump($contents);

    ?>

Приведённый выше пример выведет:

    array(3) {
      [0]=>
      string(11) "public_html"
      [1]=>
      string(10) "public_ftp"
      [2]=>
      string(3) "www"

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

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open