PHP 大会日本 2024

rar://

rar://RAR

描述

此包装器接受 URL 编码的 RAR 归档路径(相对或绝对)、一个可选星号(*)、一个可选井号(#)和一个可选的 URL 编码的条目名称(存储在归档中)。指定条目名称需要井号;条目名称中的前导斜杠是可选的。

此包装器可以打开文件和目录。打开目录时,星号会强制返回未编码的目录条目名称。如果未指定,则将返回 URL 编码的名称——这样做的原因是为了允许包装器与内置功能(例如 RecursiveDirectoryIterator)一起正确使用,即使文件名看起来像 URL 编码的数据。

如果没有包含井号和条目名称部分,则将显示归档的根目录。这与普通目录不同,因为生成的流不包含修改时间等信息,因为根目录未存储在归档中的单个条目中。使用此包装器和 RecursiveDirectoryIterator 需要在访问根目录时包含井号,以便可以正确构造子项的 URL。

注意此包装器默认情况下未启用
为了使用 rar:// 包装器,必须安装来自 » PECL» rar 扩展。

rar:// 自 PECL rar 3.0.0 起可用

用法

  • rar://<url 编码的归档名称>[*][#[<url 编码的条目名称>]]

选项

包装器摘要
属性 支持
allow_url_fopen 限制
allow_url_include 限制
允许读取
允许写入
允许追加
允许同时读取和写入
支持 stat()
支持 unlink()
支持 rename()
支持 mkdir()
支持 rmdir()

上下文选项
名称 用法 默认值
open_password 用于加密归档标头的密码(如果有)。如果存在标头密码,WinRAR 将使用与标头密码相同的密码加密所有文件,因此对于具有加密标头的归档,file_password 将被忽略。  
file_password 用于加密文件的密码(如果有)。如果标头也已加密,则此选项将被忽略,而采用 open_password。有两个选项的原因是为了涵盖支持具有不同标头和文件密码的归档的可能性,如果出现此类归档。  
volume_callback 一个回调函数,用于确定缺少卷的路径。有关更多信息,请参阅 RarArchive::open()  

示例

示例 #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));
/* creation and last access date is opt-in in WinRAR, hence most
* files don't have them */
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
)
添加注释

用户贡献注释

此页面没有用户贡献的注释。
To Top