PHP8 Phar::extractTo

2024-02-20 09:17 更新

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)

Phar::extractTo — 將 phar 存檔的內(nèi)容解壓到目錄中

說(shuō)明

public Phar::extractTo(string $directory, array|string|null $files = null, bool $overwrite = false): bool

將 phar 存檔中的所有文件解壓縮到磁盤(pán)。提取的文件和目錄將保留 存儲(chǔ)在存檔中的權(quán)限??蛇x參數(shù)允許可選控制 提取了哪些文件,以及是否可以覆蓋磁盤(pán)上的現(xiàn)有文件。 第二個(gè)參數(shù)可以是文件的名稱,也可以是文件的名稱 要提取的目錄,或要提取的文件和目錄的名稱數(shù)組。由 默認(rèn),此方法不會(huì)覆蓋現(xiàn)有文件,第三個(gè)參數(shù)可以是 設(shè)置為 true 以啟用文件覆蓋。 此方法類似于 ZipArchive::extractTo()。files

參數(shù) 

directory

提取給定 to 的路徑files

files

要提取的文件或目錄的名稱,或要提取的文件/目錄數(shù)組的名稱,null 跳過(guò)此參數(shù)

overwrite

設(shè)置為 true 可覆蓋現(xiàn)有文件

返回值 

成功時(shí)返回 true,但最好檢查拋出的異常, 如果沒(méi)有拋出,則假設(shè)成功。

錯(cuò)誤/異常 

如果刷新時(shí)發(fā)生錯(cuò)誤,則引發(fā) PharException 對(duì)磁盤(pán)的更改。

示例 

示例 #1 A Phar::extractTo() example

<?php
try {
    $phar = new Phar('myphar.phar');
    $phar->extractTo('/full/path'); // extract all files
    $phar->extractTo('/another/path', 'file.txt'); // extract only file.txt
    $phar->extractTo('/this/path',
        array('file1.txt', 'file2.txt')); // extract 2 files only
    $phar->extractTo('/third/path', null, true); // extract all files, and overwrite
} catch (Exception $e) {
    // handle errors
}
?>

注釋 

注意:Windows NTFS 文件系統(tǒng) 不支持文件名中的某些字符,即 .帶尾隨點(diǎn)的文件名 也不支持。與某些提取工具相反,此方法不會(huì)將這些字符替換為 下劃線,但無(wú)法提取此類文件。<|>*?":

參見(jiàn) 

  • PharData::extractTo() - 將 tar/zip 存檔的內(nèi)容解壓到目錄中


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

掃描二維碼

下載編程獅App

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

編程獅公眾號(hào)