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)容解壓到目錄中

說明

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

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

參數(shù) 

directory

提取給定 to 的路徑files

files

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

overwrite

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

返回值 

成功時返回 true,但最好檢查拋出的異常, 如果沒有拋出,則假設成功。

錯誤/異常 

如果刷新時發(fā)生錯誤,則引發(fā) PharException 對磁盤的更改。

示例 

示例 #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) 不支持文件名中的某些字符,即 .帶尾隨點的文件名 也不支持。與某些提取工具相反,此方法不會將這些字符替換為 下劃線,但無法提取此類文件。<|>*?":

參見 

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


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

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號