dir

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

    dir — Devuelve una instancia de la clase Directory

    Descripción

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

    Una forma pseudo orientada a objetos de leer un directorio. El directorio proporcionado en directory es abierto.

    Parámetros

    directory

    Directorio a abrir

    context

    Nota: Soporte para context fue añadido en PHP 5.0.0. Para una descripción de contexts, refiérase a Flujos.

    Valores devueltos

    Devuelve una instancia de la clase Directory, null cuando si los parámetros son incorrectos o false en caso de cualquier otro error.

    Ejemplos

    Ejemplo #1 Ejemplo de dir()

    Atención a la forma en la que el valor de retorno de Directory::read() se comprueba en el siguiente ejemplo. Es necesario verificar si el valor de retorno es igual (tanto en valor como en tipo - ver Operadores de comparación para más información) a false, ya que de lo contrario, cualquier directorio cuyo nombre evaluase a false finalizaría el bucle.

    <?php
    $d     = dir("/etc/php5");
    echo     "Handle: " . $d->handle . "\n";
    echo     "Path: " . $d->path . "\n";
    while (    false !== ($entry = $d->read())) {
    echo     $entry."\n";
    }
    $d->close();
    ?>

    El resultado del ejemplo sería algo similar a:

    Handle: Resource id #2 Path: /etc/php5 . .. apache cgi cli

    Notas

    Nota:

    El orden en el que los archivos de un directorio son devueltos por el método de lectura depende del sistema.

    To Top