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

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

Se puede emplear un URL como nombre de fichero con esta función si las envolturas de fopen han sido activadas. Véase fopen() para más información de cómo especificar el nombre de fichero. Véanse las Protocolos y Envolturas soportados; continen enlaces con información sobre las diferentes capacidades que tienen las envolturas, notas sobre su empleo, e información de cualquier variable predefinida que podría proporcionarse.

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