rar:// — RAR
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
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));
/* datas de criação e de último acesso são opcionais no WinRAR, por isso a maioria
* dos arquinos não as possui */
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 )