(PHP 4, PHP 5, PHP 7)
readdir — Lee una entrada desde un gestor de directorio
$dir_handle
] ) : stringDevuelve el nombre de la siguiente entrada del directorio. Las entradas son devueltas en el orden en que fueron almacenadas por el sistema de ficheros.
Retorna el nombre de la entrada en caso de éxito o FALSE
en caso de error.
Esta función puede
devolver el valor booleano FALSE
, pero también puede devolver un valor no booleano que se
evalúa como FALSE
. Por favor lea la sección sobre Booleanos para más
información. Use el operador
=== para comprobar el valor devuelto por esta
función.
Ejemplo #1 Listar todas las entradas de un directorio
Por favor observe que 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 FALSE
detendrá
el ciclo (p.ej. un directorio llamado "0").
<?php
if ($gestor = opendir('/path/to/files')) {
echo "Gestor de directorio: $gestor\n";
echo "Entradas:\n";
/* Esta es la forma correcta de iterar sobre el directorio. */
while (false !== ($entrada = readdir($gestor))) {
echo "$entrada\n";
}
/* Esta es la forma errónea de iterar sobre el directorio. */
while ($entrada = readdir($gestor)) {
echo "$entrada\n";
}
closedir($gestor);
}
?>
Ejemplo #2 Listar todas las entradas del directorio actual y descartar . y ..
<?php
if ($gestor = opendir('.')) {
while (false !== ($entrada = readdir($gestor))) {
if ($entrada != "." && $entrada != "..") {
echo "$entrada\n";
}
}
closedir($gestor);
}
?>