PHP Conference Japan 2024

    PharData::extractTo

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

    PharData::extractTo — 将 tar/zip 档案的内容提取到目录中

    描述

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

    将 tar/zip 档案中的所有文件提取到磁盘。提取的文件和目录保留在档案中存储的权限。可选参数允许对要提取的文件进行可选控制，以及是否可以覆盖磁盘上的现有文件。第二个参数files可以是要提取的文件或目录的名称，也可以是要提取的文件和目录名称的数组。默认情况下，此方法不会覆盖现有文件，可以将第三个参数设置为 true 以启用文件覆盖。此方法类似于ZipArchive::extractTo()。

    参数

    directory

    将给定的files提取到的路径

    files

    要提取的文件或目录的名称，或要提取的文件/目录的数组

    overwrite

    设置为true以启用覆盖现有文件

    返回值

    成功时返回true，但最好检查是否抛出异常，并在没有抛出异常的情况下假定成功。

    错误/异常

    如果在将更改刷新到磁盘时发生错误，则抛出PharException。

    示例

    示例 #1 PharData::extractTo() 示例

    <?php
    try {
    $phar = new PharData('myphar.tar');
    $phar->extractTo('/full/path'); // 提取所有文件
    $phar->extractTo('/another/path', 'file.txt'); // 仅提取 file.txt
    $phar->extractTo('/this/path',
    array(    'file1.txt', 'file2.txt')); // 仅提取 2 个文件
    $phar->extractTo('/third/path', null, true); // 提取所有文件并覆盖
    } catch (Exception $e) {
    // 处理错误
    }
    ?>

    注释

    注意:

    Windows NTFS 文件系统不支持文件名中的一些字符，即<|>*?":。也不支持以点结尾的文件名。与某些提取工具相反，此方法不会用下划线替换这些字符，而是无法提取此类文件。

    参见

    发现问题？

    了解如何改进此页面 • 提交拉取请求 • 报告错误
    ＋添加注释

    用户贡献的注释 3 条注释

    1
    njh at aelius dot com
    11 年前
    请注意，PHAR 仅支持提取 tar 档案的“ustar”变体。

    某些系统（例如较旧版本的 Mac OS X）默认生成“pax”格式。

    有关更多信息，请参见此处
    https://php.net/manual/pl/phar.fileformat.tar.php
    1
    匿名
    7 年前
    我无法从 tar 档案中提取第一个目录
    目标目录仍然为空，
    没有抛出错误

    <?php
    $tar     = new \PharData('archive.tar');
    if (    $tar->current()->isDir()) {
    echo     'is_dir';
    $dir = $tar->current()->getPathname();
    $dir = basename($dir);
    $tar->extractTo('destination', $dir);
    }
    ?>

    文档暗示第二个参数可以是文件或目录的名称，以从档案中提取，这真的可能吗？
    1
    Daniel
    7 个月前
    这是一个使用 Phar 的 decompress() 和 extractTo() 方法解压缩和解压缩 TAR.GZ 文件的示例

    <?php
    echo '<h1>TAR.GZ 解压缩</h1>';

    $file_name = 'your_file.tar.gz';
    $tar_file_name = str_replace('.gz', '', $file_name);
    $dir_file_name = str_replace('.tar.gz', '', $file_name);

    // 从 gz 解压缩并创建 your_file.tar
    $p = new PharData($file_name);
    $p->decompress();

    // 从 tar 解压缩到文件夹“your_file”
    $phar = new PharData($tar_file_name);
    $phar->extractTo($dir_file_name);

    echo     '<h1>完成</h1>';
    ?>
    ＋添加注释
    To Top