rar://

    rar:// — RAR

    Descrição

    Este empacotadorusa o caminho para o arquivo RAR (relativo ou absoluto) codificado em url, um asterisco opcional (*), um símbolo de número opcional (#) e uma entrada de nome opcional codificada em url, como armazaenado no arquivo. Especificar uma entrada de nome requer o símbolo de número; Uma barra (/) no início da entrada de nome é opcional.

    Este empacotador pode abrir tanto arquivos quanto diretórios. Quando abre diretórios, o asterisco força o retorno não codificado dos nomes das entradas do diretório. Se não houver asterisco, eles serão retornados com codificação url – a razão para isto é permitir que o empacotador seja usado corretamente com funcionalidades internas como RecursiveDirectoryIterator na presença de nomes de arquivo que se parecem com dados codificados de url.

    Se o símbolo de número (#) e a parte de nome de entrada não forem incluídos, a raiz do arquivos será mostrada. Isto difere de diretórios comuns pelo fato que o fluxo resultante não conterá informação como horário de modificação, já que o diretório raiz não é armazenado em uma entrada individual no arquivo. O uso do empacotador com RecursiveDirectoryIterator requer que o símbolo de número seja inclupido na URL ao acessar a raiz, para que as URLs dos ramos filhos sejam construídos corretamente.

    Nota: Este empacotador não é habilitado por padrão
    Para usar o empacotador rar://, a extensão » rar disponível em » PECL deve ser instalada.

    rar:// Disponível desde o PECL rar 3.0.0

    Uso

    • rar://<nome de arquivo codificado como url>[*][#[<nome de entrada codificado como url>]]

    Opções

    Sumário do Empacotador
    AtributoSuportado
    Restrito por allow_url_fopenNão
    Restrito por allow_url_includeNão
    Permite LeituraSim
    Permite EscritaNão
    Permite AdiçãoNão
    Permite Leitura e Escrita SimultâneasNão
    Suporta stat()Sim
    Suporta unlink()Não
    Suporta rename()Não
    Suporta mkdir()Não
    Suporta rmdir()Não

    Opções de contexto
    NomeUsoPadrão
    open_passwordA senha utilizada para criptografar os cabeçalhos do arquivo, se houver. WinRAR irá criptografar todos os arquivos com a mesma senha do cabeçalho quando ela estiver presente, ou seja, para arquivos com cabeçalhos criptografados, file_password será ignorada.  
    file_passwordA senha utilizada para criptografar um arquivo, se houver. Se os cabeçalhos também estiverem criptografados, esta opção será ignorada em favor de open_password. A razão pela qual existem duas opções é para cobrir a possibilidade de suportar arquivos com senhas diferentes para cabeçalhos e arquivos, se este tipo de arquivo porventura vier a existir. Note que se o arquivo não tiver seus cabeçalhos criptografados, open_password será ignorada e esta opção deve ser usada no lugar.  
    volume_callbackUm callback para determinar o caminho de volumes faltantes. Consulte RarArchive::open() para mais informação.  

    Exemplos

    Exemplo #1 Explorando um arquivo RAR

    <?php

    class MyRecDirIt extends RecursiveDirectoryIterator {
    function     current() {
    return     rawurldecode($this->getSubPathName()) .
    (    is_dir(parent::current())?" [DIR]":"");
    }
    }

    $f = "rar://" . rawurlencode(dirname(__FILE__)) .
    DIRECTORY_SEPARATOR . 'dirs_and_extra_headers.rar#';

    $it = new RecursiveTreeIterator(new MyRecDirIt($f));

    foreach (    $it as $s) {
    echo     $s, "\n";
    }
    ?>

    O exemplo acima produzirá algo semelhante a:

    |-allow_everyone_ni [DIR] |-file1.txt |-file2_אּ.txt |-with_streams.txt \-אּ [DIR] |-אּ\%2Fempty%2E [DIR] | \-אּ\%2Fempty%2E\file7.txt |-אּ\empty [DIR] |-אּ\file3.txt |-אּ\file4_אּ.txt \-אּ\אּ_2 [DIR] |-אּ\אּ_2\file5.txt \-אּ\אּ_2\file6_אּ.txt

    Exemplo #2 Abrindo um arquivo criptografado (criptografia de cabeçalho)

    <?php
    $stream     = fopen("rar://" .
    rawurlencode(dirname(__FILE__)) . DIRECTORY_SEPARATOR .
    'encrypted_headers.rar' . '#encfile1.txt', "r", false,
    stream_context_create(
    array(
    'rar' =>
    array(
    'open_password' => 'samplepassword'
    )
    )
    )
    );
    var_dump(stream_get_contents($stream));

    var_dump(fstat($stream));
    ?>

    O exemplo acima produzirá algo semelhante a:

    string(26) "Encrypted file 1 contents." Array ( [0] => 0 [1] => 0 [2] => 33206 [3] => 1 [4] => 0 [5] => 0 [6] => 0 [7] => 26 [8] => 0 [9] => 1259550052 [10] => 0 [11] => -1 [12] => -1 [dev] => 0 [ino] => 0 [mode] => 33206 [nlink] => 1 [uid] => 0 [gid] => 0 [rdev] => 0 [size] => 26 [atime] => 0 [mtime] => 1259550052 [ctime] => 0 [blksize] => -1 [blocks] => -1 )
    To Top