PHP8 Phar::convertToData
PHP 5 >= 5.3.0， PHP 7， PHP 8， PECL phar >= 2.0.0）
Phar：：convertToData — 将 phar 存档转换为不可执行的 tar 或 zip 文件
说明
public Phar::convertToData(?int $format = null, ?int $compression = null, ?string $extension = null): ?PharData此方法用于将可执行的 phar 存档转换为 tar 或 zip 文件。要使 tar 或 zip 不可执行，phar 存根和 phar 别名文件将从新创建的存档中删除。
如果未指定任何更改，则如果存档为 phar 文件格式，则此方法将引发 BadMethodCallException。对于 tar 或 zip 文件格式的存档， 此方法将存档转换为不可执行的存档。
如果成功，该方法将在磁盘上创建一个新的存档，并返回一个 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 Phar：：convertToData（） example
使用 Phar：：convertToData（）：
<?php
try {
$tarphar = new Phar('myphar.phar.tar');
// note that myphar.phar.tar is *not* unlinked
// convert it to the non-executable tar file format
// creates myphar.tar
$tar = $tarphar->convertToData();
// convert to non-executable zip format, creates myphar.zip
$zip = $tarphar->convertToData(Phar::ZIP);
// create myphar.tbz
$tgz = $tarphar->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 存档文件格式
- PharData：：convertToExecutable（） - 将不可执行的 tar/zip 存档转换为可执行的 phar 存档
- PharData：：convertToData（） - 将 phar 存档转换为不可执行的 tar 或 zip 文件
更多建议：