streamWrapper::dir_readdir

    (PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

    streamWrapper::dir_readdir — Leer una entrada desde el gestor de directorio

    Descripción

    publicstreamWrapper::dir_readdir(): string

    Este método es llamado en respuesta a readdir().

    Parámetros

    Esta función no tiene parámetros.

    Valores devueltos

    Debería devolver un valor de tipo string que representa el siguiente nombre de archivo, o false si no hay un siguiente archivo.

    Nota:

    El valor devuelto será convertido a un valor de tipo string.

    Errores/Excepciones

    Emite un E_WARNING si la llamada a este método falla (por ej., por no estar implementado).

    Ejemplos

    Ejemplo #1 Listar los ficheros de archivos tar

    <?php
    class streamWrapper {
    protected     $fp;

    public function     dir_opendir($ruta, $opciones) {
    $url = parse_url($ruta);

    $ruta = $url["host"] . $url["path"];

    if (!    is_readable($ruta)) {
    trigger_error("$ruta no es legible por mí", E_USER_NOTICE);
    return     false;
    }
    if (!    is_file($ruta)) {
    trigger_error("$ruta no es un fichero", E_USER_NOTICE);
    return     false;
    }

    $this->fp = fopen($ruta, "rb");
    return     true;
    }

    public function     dir_readdir() {
    // Extraer la cabecera para esta entrada
    $cabecera = fread($this->fp, 512);
    $data = unpack("a100filename/a8mode/a8uid/a8gid/a12size/a12mtime/a8checksum/a1filetype/a100link/a100linkedfile", $cabecera);

    // Recortar el nombre de archivo y tamaño de archivo
    $nombre_archivo = trim($data["filename"]);

    // ¿No hay nombre de archivo? Estamos en el final del archivo tar
    if (!$nombre_archivo) {
    return     false;
    }

    $octal_bytes = trim($data["size"]);
    // El tamaño de archivo es definido en octetos
    $bytes = octdec($octal_bytes);

    // tar redondea hacia arriba en múltiplos de 512 bytes (rellenando con ceros)
    $resto = $bytes % 512;
    if (    $resto > 0) {
    $bytes += 512 - $resto;
    }

    // Buscar sobre el archivo
    fseek($this->fp, $bytes, SEEK_CUR);

    return     $nombre_archivo;
    }

    public function     dir_closedir() {
    return     fclose($this->fp);
    }

    public function     dir_rewinddir() {
    return     fseek($this->fp, 0, SEEK_SET);
    }
    }

    stream_wrapper_register("tar", "streamWrapper");
    $gestor = opendir("tar://ejemplo.tar");
    while (    false !== ($file = readdir($gestor))) {
    var_dump($file);
    }

    echo     "Rewinding..\n";
    rewind($gestor);
    var_dump(readdir($gestor));

    closedir($gestor);
    ?>

    El resultado del ejemplo sería algo similar a:

    string(13) "construct.xml" string(16) "dir-closedir.xml" string(15) "dir-opendir.xml" string(15) "dir-readdir.xml" string(17) "dir-rewinddir.xml" string(9) "mkdir.xml" string(10) "rename.xml" string(9) "rmdir.xml" string(15) "stream-cast.xml" string(16) "stream-close.xml" string(14) "stream-eof.xml" string(16) "stream-flush.xml" string(15) "stream-lock.xml" string(15) "stream-open.xml" string(15) "stream-read.xml" string(15) "stream-seek.xml" string(21) "stream-set-option.xml" string(15) "stream-stat.xml" string(15) "stream-tell.xml" string(16) "stream-write.xml" string(10) "unlink.xml" string(12) "url-stat.xml" Rewinding.. string(13) "construct.xml"

    Ver también

    • readdir() - Lee una entrada desde un gestor de directorio
    To Top