(PHP 4, PHP 5, PHP 7, PHP 8)
readdir — Lee una entrada desde un gestor de directorio
Devuelve 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";
while (false !== ($entrada = readdir($gestor))) {
echo "$entrada\n";
}
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);
}
?>