scandir

(PHP 5, PHP 7, PHP 8)

scandir Lista los ficheros y directorios en un directorio

Descripción

scandir(string $directory, int $sorting_order = SCANDIR_SORT_ASCENDING, ?resource $context = null): array|false

Devuelve un array de ficheros y directorios, provenientes de directory.

Parámetros

directory

El directorio que será analizado.

sorting_order

Por omisión, el orden es alfabético ascendente. Si el parámetro opcional sorting_order es definido a SCANDIR_SORT_DESCENDING, entonces el orden será alfabético descendente. Si este parámetro es definido a SCANDIR_SORT_NONE, entonces el resultado no será ordenado.

context

Para una descripción del parámetro context, consulte la sección flujo de datos del manual.

Valores devueltos

Devuelve un array de ficheros en caso de éxito o false en caso de fallo. Si directory no es un directorio, entonces se devuelve un valor booleano false y se genera un error de nivel E_WARNING.

Historial de cambios

Versión Descripción
8.0.0 context ahora es nullable.

Ejemplos

Ejemplo #1 Un simple ejemplo con scandir()

<?php
$dir
= '/tmp';
$files1 = scandir($dir);
$files2 = scandir($dir, SCANDIR_SORT_DESCENDING);

print_r($files1);
print_r($files2);
?>

Resultado del ejemplo anterior es similar a :

Array
(
    [0] => .
    [1] => ..
    [2] => bar.php
    [3] => foo.txt
    [4] => somedir
)
Array
(
    [0] => somedir
    [1] => foo.txt
    [2] => bar.php
    [3] => ..
    [4] => .
)

Notas

Sugerencia

Puede utilizar una URL como nombre de archivo con esta función, si el gestor fopen ha sido activado. Véase fopen() para más detalles sobre cómo especificar el nombre del archivo. Consulte Protocolos y Envolturas soportados para más información sobre las capacidades de los diferentes gestores, las notas sobre su uso, así como la información sobre las variables predefinidas que proporcionan.

Ver también

  • opendir() - Abre un directorio y recupera un puntero sobre él
  • readdir() - Lee una entrada del directorio
  • glob() - Búsqueda de rutas que coinciden con un patrón
  • is_dir() - Indica si el fichero es un directorio
  • sort() - Ordena un array en orden creciente