dir

(PHP 4, PHP 5, PHP 7, PHP 8)

dirDevuelve una instancia de la clase Directory

Descripción

dir(string $directory, ?resource $context = null): Directory|false

Un mecanismo pseudo-objeto permite la lectura de un directorio. El argumento directory es abierto.

Parámetros

directory

El directorio a abrir

context

Un resource de contextos de flujos.

Valores devueltos

Devuelve una instancia de la clase Directory en caso de éxito, o false en caso de error.

Historial de cambios

Versión Descripción
8.0.0 context ahora es nullable.

Ejemplos

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

Notas

Nota:

El orden en el que las entradas del directorio son devueltas con el método read depende del sistema.