rar:// — RAR
封装协议采用 url 编码,(相对/绝对)路径的 RAR 归档、一个可选的星号(*
)、一个可选的井号(#
)和一个可选的存储在归档中的 url 编码条目名称。指定条目名称必须带有井号,条目名称开头的斜线是可选的。
该封装协议可以打开文件和目录。当打开目录时,星号会强制返回未编码的目录条目名称。如果不指定星号,将返回 URL 编码的目录条目名称 —— 这样做的原因是存在类似 URL 编码的文件名时,允许封装协议能够与内置方法(比如 RecursiveDirectoryIterator)一起正确使用。
如果不包含井号和条目名称部分,将会显示归档的根目录。与常规目录不同的是生成的流不会包含诸如修改时间之类的信息, 因为根目录不会存储在归档的条目中。当访问根目录时, RecursiveDirectoryIterator 与封装协议一起使用时需要在 ULR 中包含井号,以便正确构建子级 URL。
注意: 该封装协议不会默认启用
为了使用 rar:// 封装协议,必须从 » PECL 中安装有效的 » rar 扩展。
rar:// 自 PECL rar 3.0.0 起可用
示例 #1 遍历 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";
}
?>
以上示例的输出类似于:
|-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
示例 #2 打开加密文件(报头加密)
<?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));
/* 在 WinRAR 中创建日期和最后访问日期是可选的,
* 因此大多数文件都没有 */
var_dump(fstat($stream));
?>
以上示例的输出类似于:
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 )