PHP8 Phar::extractTo
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::extractTo — 将 phar 存档的内容解压到目录中
说明
public Phar::extractTo(string $directory, array|string|null $files = null, bool $overwrite = false): bool
将 phar 存档中的所有文件解压缩到磁盘。提取的文件和目录将保留 存储在存档中的权限。可选参数允许可选控制 提取了哪些文件,以及是否可以覆盖磁盘上的现有文件。 第二个参数可以是文件的名称,也可以是文件的名称 要提取的目录,或要提取的文件和目录的名称数组。由 默认,此方法不会覆盖现有文件,第三个参数可以是 设置为 true 以启用文件覆盖。 此方法类似于 ZipArchive::extractTo()。files
参数
directory
提取给定 to 的路径
files
files
要提取的文件或目录的名称,或要提取的文件/目录数组的名称,
null
跳过此参数overwrite
设置为
true
可覆盖现有文件
返回值
成功时返回 true,但最好检查抛出的异常, 如果没有抛出,则假设成功。
错误/异常
如果刷新时发生错误,则引发 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 文件系统 不支持文件名中的某些字符,即 .带尾随点的文件名 也不支持。与某些提取工具相反,此方法不会将这些字符替换为 下划线,但无法提取此类文件。<|>*?":
参见
- PharData::extractTo() - 将 tar/zip 存档的内容解压到目录中