scandir

(PHP 5)

scandir — Lista los archivos y directorios ubicados en la ruta especificada

Descripción

array scandir ( string $directorio [, int $sentido_de_ordenamiento [, resource $contexto ]] )

Devuelve un array de archivos y directorios que se encuentran bajo directorio .

Lista de parámetros

directorio: El directorio que será procesado.
sendito_de_ordenamiento: Por defecto, el sentido del ordenamiento es ascendente. Si es usado el parámetro opcional sentido_de_ordenamiento (definido como 1), entonces el sentido será descendente.
context: Para una descripción del parámetro contexto , refiérase a la sección de secuencias del manual.

Valores retornados

Devuelve un valor array con nombres de archivo en case de éxito, o FALSE en caso de fallo. Si directorio no es un directorio, entonces el valor booleano FALSE es retornado, y se genera un error de nivel E_WARNING.

Ejemplos

Example#1 Un ejemplo simple de scandir()


<?php
$dir    = '/tmp';
$archivos1 = scandir($dir);
$archivos2 = scandir($dir, 1);

print_r($archivos1);
print_r($archivos2);
?>

El resultado del ejemplo seria algo similar a:

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

Example#2 Alternativas a scandir() con PHP 4


<?php
$dir = "/tmp";
$dh  = opendir($dir);
while (false !== ($nombre_archivo = readdir($dh))) {
    $archivos[] = $nombre_archivo;
}

sort($archivos);

print_r($archivos);

rsort($archivos);

print_r($archivos);

?>

El resultado del ejemplo seria algo similar a:

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

Notes

Tip

Puede usar una URL como nombre de archivo con esta función si los fopen wrappers han sido activados. Consulte fopen() para más detalles sobre cómo especificar el nombre de fichero y Lista de Protocolos/Envolturas Soportadas una lista de protocolos URL soportados

Ver también

Directorios

DOM