PHP8 PharData::convertToData
（PHP 5 >= 5.3.0， PHP 7， PHP 8， PECL phar >= 2.0.0）
PharData：：convertToData — 将 phar 存档转换为不可执行的 tar 或 zip 文件
说明
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::ZIPcompression这应该是没有完整存档的档案之一 压缩，用于基于 zlib 的压缩和基于 bzip 的压缩。
Phar::NONEPhar::GZPhar::BZ2extension此参数用于覆盖 转换后的存档。不能使用的注意事项 不可执行 tar 或 zip 存档的文件名中的任意位置。
.phar如果转换为基于 tar 的 phar 存档， 默认扩展名为 、 、 并取决于指定的压缩。 对于基于 zip 的存档， 默认扩展名为 。
.tar.tar.gz.tar.bz2.zip
返回值
该方法在成功时返回一个 PharData 对象， 或失败时为 null。
错误／异常
此方法在无法时引发 BadMethodCallException 要压缩，已指定未知的压缩方法，请求的 archive 正在使用 Phar：：startBuffering（） 和 尚未以 Phar：：stopBuffering（） 结束，如果遇到任何问题，则为 PharException 在 phar 创建过程中。
更新日志
| 版本 | 说明 |
|---|---|
| 8.0.0 | format、 和 现在可为 null。compressionextension |
示例
示例 #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 存档
更多建议：