ftp_nlist

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

ftp_nlistDevuelve la lista de ficheros de un directorio

Descripción

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

Parámetros

ftp

An FTP\Connection instance.

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 The ftp parameter expects an FTP\Connection instance now; previously, a recurso was expected.

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);

?>

El resultado del ejemplo sería algo 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