PHP8 RarEntry::extract

2024-02-23 11:45 更新

(PECL rar >= 0.1)

RarEntry::extract — 從存檔中提取條目

說(shuō)明

public RarEntry::extract(
    string $dir,
    string $filepath = "",
    string $password = NULL,
    bool $extended_data = false
): bool

RarEntry::extract() 提取條目的數(shù)據(jù)。 它將在指定的文件中創(chuàng)建新文件,其名稱(chēng)與條目的名稱(chēng)相同, 除非指定了第二個(gè)參數(shù)。有關(guān)詳細(xì)信息,請(qǐng)參閱下文。dir

參數(shù) 

dir

應(yīng)提取文件的目錄的路徑。此參數(shù)為 當(dāng)且僅當(dāng)不是時(shí)才考慮。如果兩者兼而有之 參數(shù)為空,解壓到當(dāng)前目錄將是 企圖。filepath

filepath

包含目錄和文件名的路徑(相對(duì)或絕對(duì)路徑) 提取的文件。此參數(shù)將覆蓋參數(shù)和原始文件名。dir

password

用于加密此條目的密碼。如果條目未加密,則不會(huì)使用此值,并且可以 省略。如果省略此參數(shù)并加密條目,則將使用提供給 rar_open() 的密碼(如果有)。如果輸入了錯(cuò)誤的密碼,則顯式 或通過(guò) rar_open() 隱式,CRC 檢查將失敗,此方法將失敗并返回 false。 如果未提供密碼,并且需要密碼,則此方法將失敗并返回 false。 您可以使用 RarEntry::isEncrypted() 檢查條目是否加密。

extended_data

如果為 true,則將在數(shù)據(jù)提取中設(shè)置擴(kuò)展信息,例如 NTFS ACL 和 Unix 所有者信息 文件,只要它存在于存檔中即可。

警告

在版本 2.0.0 之前,此函數(shù)不會(huì)處理相對(duì) 正確的路徑。使用 realpath() 作為解決方法。

返回值 

成功時(shí)返回 true, 或者在失敗時(shí)返回 false。

更新日志 

版本說(shuō)明
PECL rar 3.0.0extended_data被添加。
PECL rar 3.0.0對(duì)具有重復(fù)條目名稱(chēng)的 RAR 存檔的支持不再有缺陷。

示例 

示例 #1 RarEntry::extract() example

<?php

$rar_file = rar_open('example.rar') or die("Failed to open Rar archive");

$entry = rar_entry_get($rar_file, 'Dir/file.txt') or die("Failed to find such entry");

$entry->extract('/dir/to'); // create /dir/to/Dir/file.txt
$entry->extract(false, '/dir/to/new_name.txt'); // create /dir/to/new_name.txt

?>

示例 #2 如何提取存檔中的所有文件:

<?php

/* example by Erik Jenssen aka erix */

$filename = "foobar.rar";
$filepath = "/home/foo/bar/";

$rar_file = rar_open($filepath.$filename);
$list = rar_list($rar_file);
foreach($list as $file) {
    $entry = rar_entry_get($rar_file, $file);
    $entry->extract("."); // extract to the current dir
}
rar_close($rar_file);

?>

參見(jiàn) 

  • RarEntry::getStream() - 獲取條目的文件處理程序
  • rar:// wapper


以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)