Directorio Funciones
PHP Manual

readdir

(PHP 4, PHP 5)

readdirLee una entrada desde un gestor de directorio

Descripción

string readdir ([ resource $dir_handle ] )

Devuelve el nombre del siguiente archivo leído desde el directorio. Los nombres de archivo son devueltos en el orden en que son almacenados por el sistema de archivos.

Parámetros

gestor_dir

El gestor de directorio resource previamente abierto por opendir(). Si el gestor de directorio no se especifica, la ultima conexión abierta por opendir() es asumida.

Valores devueltos

Retorna el nombre del archivo en caso de éxito o FALSE en caso de error.

Warning

Esta función quizá devuelve Boolean FALSE, pero quizá también devuelve un valor non-Boolean que se evaluará como FALSE, como 0 o "". Por favor lea la sección en Booleans para más información. Use el operador === para testear el valor devuelto por esta función.

Ejemplos

Example #1 Listar todos lso archivos en un directorio

Por favor note la forma en que el valor de retorno de readdir() es chequeado en los siguientes ejemplos. Se está probando explícitamente si el valor de retorno es idéntico (igual y del mismo tipo, vea los Operadores de Comparación para más información) a FALSE ya que de otra forma, cualquier entrada de directorio cuyo nombre evalúe a FALSEdetendrá el ciclo (p.ej. un directorio llamado "0").

<?php
 
if ($gestor opendir('/path/to/files')) {
    echo 
"Gestor de directorio: $gestor\n";
    echo 
"Archivos:\n";
 
    
/* Esta es la forma correcta de iterar sobre el directorio. */
    
while (false !== ($archivo readdir($gestor))) {
        echo 
"$archivo\n";
    }
 
    
/* Esta es la forma errónea de iterar sobre el directorio. */
    
while ($archivo readdir($gestor)) {
        echo 
"$archivo\n";
    }
 
    
closedir($gestor);
}
?>

Example #2 Listar todos los archivos en el directorio actual y eliminar . y ..

<?php
if ($gestor opendir('.')) {
    while (
false !== ($archivo readdir($gestor))) {
        if (
$archivo != "." && $archivo != "..") {
            echo 
"$archivo\n";
        }
    }
    
closedir($gestor);
}
?>

Ver también


Directorio Funciones
PHP Manual