Devuelve la lista de ficheros de un directorio

# ftp_nlist

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

ftp_nlist — Devuelve la lista de ficheros de un directorio

### Descripción

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

### Parámetros

`ftp`
  Una instancia de FTP\Connection.
`directory`

  El directorio a listar. Este argumento puede incluir argumentos adicionales, e.g. `ftp_nlist($ftp, "-la /your/dir");` Tenga en cuenta que este argumento no se escapa, por lo que pueden producirse comportamientos no deseados si el nombre de los ficheros contiene espacios u otros caracteres.

### Valores devueltos

Devuelve un array con los nombres de ficheros presentes en el directorio especificado en caso de éxito o `false` si ocurre un error.

### Historial de cambios

Versión | Descripción
--- | ---
8.1.0 | El parámetro `ftp` ahora espera una instancia de FTP\Connection ; anteriormente, se esperaba un resource.

### Ejemplos

Ejemplo #1 Ejemplo con ftp_nlist()

    <?php

    // Establecimiento de una conexión básica
    $ftp = ftp_connect($ftp_server);

    // Identificación con un nombre de usuario y una contraseña
    $login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

    // Obtención del contenido de un directorio
    $contents = ftp_nlist($ftp, ".");

    // Visualización de $contents
    var_dump($contents);

    ?>

Resultado del ejemplo anterior es similar a:

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

### Ver también

- ftp_rawlist() - Realiza una lista detallada de los ficheros de un directorio
- ftp_mlsd() - Devuelve la lista de ficheros de un directorio dado

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