scandir
En esta página
scandir
Lista los ficheros y directorios en un directorio
Descripción#
scandir(string $directory, [int $sorting_order], [resource $context]): array
```php
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](#ref.stream) del manual.
## Valores devueltos
Devuelve un `array` de nombres 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
Un simple ejemplo con `scandir`
```php
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#
[!TIP] Puede utilizar una URL como nombre de archivo con esta función, si el gestor fopen ha sido activado. Véase
fopenpara más detalles sobre cómo especificar el nombre del archivo. Consulte ??? 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.
Véase también#
opendir, readdir, glob, is_dir, sort