stream_wrapper_register

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

    stream_wrapper_register — Registra um empacotador URL implementado como uma classe PHP

    Descrição

    stream_wrapper_register(string $protocol, string $class, int $flags = 0): bool

    Permite a implementação de manipuladores de protocolo e fluxo do usuário para uso com todas as outras funções de sistemas de arquivos (como fopen(), fread() etc.).

    Parâmetros

    protocol

    O nome do empacotador a ser registrado. Nomes de protocolos válidos devem conter somente caracteres alfanuméricos, pontos (.), sinais de adição (+) ou hífens (-).

    class

    O nome da classe que implementa o protocolo definido no parâmetro protocol.

    flags

    Deve ser definida para STREAM_IS_URL se protocol for um protocolo URL. O padrão é 0, fluxo local.

    Valor Retornado

    Retorna true em caso de sucesso ou false em caso de falha.

    stream_wrapper_register() retornará false se protocol já tiver um manipulador.

    Exemplos

    Exemplo #1 Como registrar um empacotador de fluxo

    <?php
    $existed     = in_array("var", stream_get_wrappers());
    if (    $existed) {
    stream_wrapper_unregister("var");
    }
    stream_wrapper_register("var", "VariableStream");
    $myvar = "";

    $fp = fopen("var://myvar", "r+");

    fwrite($fp, "linha1\n");
    fwrite($fp, "linha2\n");
    fwrite($fp, "linha3\n");

    rewind($fp);
    while (!    feof($fp)) {
    echo     fgets($fp);
    }
    fclose($fp);
    var_dump($myvar);

    if (    $existed) {
    stream_wrapper_restore("var");
    }

    ?>

    O exemplo acima produzirá:

    linha1
linha2
linha3
string(18) "linha1
linha2
linha3
"

    Veja Também

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 2 notes

    up
    10
    cellog at php dot net
    19 years ago
    If you plan to use your wrapper in a require_once you need to define stream_stat(). If you plan to allow any other tests like is_file()/is_dir(), you have to define url_stat().

    stream_stat() must define the size of the file, or it will never be included. url_stat() must define mode, or is_file()/is_dir()/is_executable(), and any of those functions affected by clearstatcache() simply won't work.

    It's not documented, but directories must be a mode like 040777 (octal), and files a mode like 0100666. If you wish the file to be executable, use 7s instead of 6s. The last 3 digits are exactly the same thing as what you pass to chmod. 040000 defines a directory, and 0100000 defines a file. It would be really helpful to add this to the official manual!
    up
    2
    jhannus at php dot net
    19 years ago
    It is worth noting that if your wrapper supports stream_flush() then when you flcose() your stream this function will be called prior to closing the stream.
    ＋adicione uma nota
    To Top