(PHP 4, PHP 5, PHP 7, PHP 8)
dir — Devuelve una instancia de la clase Directory
Un mecanismo pseudo-objeto permite la lectura de un directorio.
El argumento directory
es abierto.
directory
El directorio a abrir
context
Un resource de contextos de flujos.
Devuelve una instancia de la clase Directory
en caso de éxito, o false
en caso de error.
Versión | Descripción |
---|---|
8.0.0 |
context ahora es nullable.
|
Ejemplo #1 Ejemplo con dir()
Observe cómo se verifica el valor de retorno de Directory::read()
en el siguiente ejemplo. Se comprueba si el valor es
idéntico (igual y del mismo tipo que -- véase operadores de comparación
para más detalles) false
de lo contrario, cualquier entrada en el nombre se evaluaría
a false
causaría la interrupción del ciclo.
<?php
$d = dir("/etc/php5");
echo "Manejador : " . $d->handle . "\n";
echo "Ruta : " . $d->path . "\n";
while (false !== ($entry = $d->read())) {
echo $entry."\n";
}
$d->close();
?>
El resultado del ejemplo sería algo similar a:
Manejador : Resource id #2 Ruta : /etc/php5 . .. apache cgi cli
Nota:
El orden en el que las entradas del directorio son devueltas con el método read depende del sistema.