rar://

rar://RAR

說明

封裝協(xié)議采用 url 編碼,(相對/絕對)路徑的 RAR 歸檔、一個可選的星號(*)、一個可選的井號(# )和一個可選的存儲在歸檔中的 url 編碼條目名稱。指定條目名稱必須帶有井號,條目名稱開頭的斜線是可選的。

該封裝協(xié)議可以打開文件和目錄。當打開目錄時,星號會強制返回未編碼的目錄條目名稱。如果不指定星號,將返回 URL 編碼的目錄條目名稱 —— 這樣做的原因是存在類似 URL 編碼的文件名時,允許封裝協(xié)議能夠與內置方法(比如 RecursiveDirectoryIterator)一起正確使用。

如果不包含井號和條目名稱部分,將會顯示歸檔的根目錄。與常規(guī)目錄不同的是生成的流不會包含諸如修改時間之類的信息, 因為根目錄不會存儲在歸檔的條目中。當訪問根目錄時, RecursiveDirectoryIterator 與封裝協(xié)議一起使用時需要在 ULR 中包含井號,以便正確構建子級 URL。

注意: 該封裝協(xié)議不會默認啟用
為了使用 rar:// 封裝協(xié)議,必須從 ? PECL 中安裝可用的 ? rar 擴展。

rar:// 自 PECL rar 3.0.0 起可用

用法

  • rar://<url encoded archive name>[*][#[<url encoded entry name>]]

可選項

封裝協(xié)議摘要
屬性 支持
受限于 allow_url_fopen No
受限于 allow_url_include No
允許讀取 Yes
允許寫入 No
允許附加 No
允許同時讀寫 No
支持 stat() Yes
支持 unlink() No
支持 rename() No
支持 mkdir() No
支持 rmdir() No

上下文選項
名稱 用法 默認
open_password 用于加密歸檔報頭的密碼(如果有)。如果存在后者,WinRAR 將使用相同的密碼作為報頭密碼加密所有文件, 因此對于帶有加密報頭的歸檔, file_password 將會被忽略。  
file_password 用于加密文件的密碼(如果有)。如果報頭也加密,這個選項將會被忽略以支持 open_password。 有兩個選項的原因是為了支持可能會出現(xiàn)的報頭和文件密碼不同的歸檔。請注意,如果歸檔沒有加密它的報頭, 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));
/* 在 WinRAR 中創(chuàng)建日期和最后訪問日期是可選的,
 * 因此大多數(shù)文件都沒有 */
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
)