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 存档的内容解压到目录中

说明

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 存档的内容解压到目录中


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号