Submit a Pull Request Report a Bug

    streamWrapper::dir_readdir

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

    streamWrapper::dir_readdir — Read entry from directory handle

    Descrição

    public streamWrapper::dir_readdir ( ) : string

    This method is called in response to readdir().

    Parâmetros

    Esta função não possui parâmetros.

    Valor Retornado

    Should return string representing the next filename, or false if there is no next file.

    Nota:

    The return value will be casted to string.

    Erros

    Emite E_WARNING se uma chamada a essa função falha (não implementada, por exemplo).

    Exemplos

    Exemplo #1 Listing files from tar archives

    <?php
    class streamWrapper {
        protected     $fp;

        public function     dir_opendir($path, $options) {
                $url = parse_url($path);

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

            if (!    is_readable($path)) {
                    trigger_error("$path isn't readable for me", E_USER_NOTICE);
                return     false;
            }
            if (!    is_file($path)) {
                    trigger_error("$path isn't a file", E_USER_NOTICE);
                return     false;
            }

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

        public function     dir_readdir() {
                // Extract the header for this entry
                $header      = fread($this->fp, 512);
                $data = unpack("a100filename/a8mode/a8uid/a8gid/a12size/a12mtime/a8checksum/a1filetype/a100link/a100linkedfile", $header);

                // Trim the filename and filesize
                $filename    = trim($data["filename"]);

                // No filename? We are the end of the archive
                if (!$filename) {
                return     false;
            }

                $octal_bytes = trim($data["size"]);
                // Filesize is defined in octects
                $bytes       = octdec($octal_bytes);

                // tar rounds up filesizes up to multiple of 512 bytes (zero filled)
                $rest        = $bytes % 512;
            if (    $rest > 0) {
                    $bytes      += 512 - $rest;
            }

                // Seek over the file
                fseek($this->fp, $bytes, SEEK_CUR);

            return     $filename;
        }

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

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

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

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

    closedir($handle);
    ?>

    O exemplo acima irá imprimir algo similar à:

    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"

    Veja Também

    • readdir() - Lê os campos do manipulador do diretório

    add a note add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top