(PHP 5, PHP 7, PHP 8)
scandir — Lista los ficheros y directorios en un directorio
$directory
, int $sorting_order
= SCANDIR_SORT_ASCENDING
, ?resource $context
= null
): array|false
Devuelve un array de ficheros y directorios, provenientes de directory
.
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.
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
.
Versión | Descripción |
---|---|
8.0.0 |
context ahora es nullable.
|
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] => . )
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.