public PharData::convertToData(?int $format = null, ?int $compression = null, ?string $extension = null): ?PharData

此方法用于将不可执行的 tar 或 zip 存档转换为另一个存档 不可执行格式。

如果未指定任何更改，此方法将引发 BadMethodCallException。 此方法应用于将 tar 存档转换为 zip 格式，反之亦然。虽然 可以使用此方法简单地更改 tar 存档的压缩， 最好使用 PharData：：compress（） 方法进行逻辑 一致性。

如果成功，该方法将在磁盘上创建一个新的存档，并返回一个 PharData 对象。旧存档不会从磁盘中删除，应在之后手动完成 该过程已完成。

参数 

format

这应该是 or 之一。如果设置为 null，则现有文件格式 将被保留。Phar::TARPhar::ZIP

compression

这应该是没有完整存档的档案之一 压缩，用于基于 zlib 的压缩和基于 bzip 的压缩。Phar::NONEPhar::GZPhar::BZ2

extension

此参数用于覆盖 转换后的存档。不能使用的注意事项 不可执行 tar 或 zip 存档的文件名中的任意位置。.phar

如果转换为基于 tar 的 phar 存档， 默认扩展名为 、 、 并取决于指定的压缩。 对于基于 zip 的存档， 默认扩展名为 。.tar.tar.gz.tar.bz2.zip

返回值 

该方法在成功时返回一个 PharData 对象， 或失败时为 null。

错误／异常 

此方法在无法时引发 BadMethodCallException 要压缩，已指定未知的压缩方法，请求的 archive 正在使用 Phar：：startBuffering（） 和 尚未以 Phar：：stopBuffering（） 结束，如果遇到任何问题，则为 PharException 在 phar 创建过程中。

更新日志 

示例 

示例 #1 A PharData::convertToData() example

使用 PharData：：convertToData（）：

<?php
try {
    $tarphar = new PharData('myphar.tar');
    // note that myphar.tar is *not* unlinked
    // convert it to the non-executable tar file format
    // creates myphar.zip
    $zip = $tarphar->convertToData(Phar::ZIP);
    // create myphar.tbz
    $tgz = $zip->convertToData(Phar::TAR, Phar::BZ2, '.tbz');
    // creates myphar.phar.tgz
    $phar = $tarphar->convertToData(Phar::PHAR); // throws exception
} catch (Exception $e) {
    // handle the error here
}
?>

参见 

• Phar：：convertToExecutable（） - 将 phar 存档转换为另一种可执行的 phar 存档文件格式
• Phar：：convertToData（） - 将 phar 存档转换为不可执行的 tar 或 zip 文件
• PharData：：convertToExecutable（） - 将不可执行的 tar/zip 存档转换为可执行的 phar 存档