PHP8 Phar::convertToExecutable
（PHP 5 >= 5.3.0， PHP 7， PHP 8， PECL phar >= 2.0.0）
Phar：：convertToExecutable — 将 phar 存档转换为另一种可执行的 phar 存档文件格式
说明
public Phar::convertToExecutable(?int $format = null, ?int $compression = null, ?string $extension = null): ?Phar注意:此方法需要 将 中的 设为 以适合 Phar 对象. 否则, 将抛出PharException.php.iniphar.readonly0
此方法用于将 phar 存档转换为另一种文件格式。例如 它可用于从基于 ZIP 的 PHAR 创建基于 Tar 的可执行 PHAR 存档 可执行 PHAR 存档，或来自 PHAR 文件格式的可执行 PHAR 存档。在 此外，它还可用于将整个存档压缩应用于基于 tar 或 PHAR 的 档案。
如果未指定任何更改，此方法将引发 BadMethodCallException。
如果成功，该方法将在磁盘上创建一个新的存档并返回一个 Phar 对象。旧存档不会从磁盘中删除，应在之后手动完成 该过程已完成。
参数
format这应该是 ， ， 或。如果设置为
null，则现有文件格式 将被保留。Phar::PHARPhar::TARPhar::ZIPcompression这应该是没有完整存档的档案之一 压缩，用于基于 zlib 的压缩和基于 bzip 的压缩。
Phar::NONEPhar::GZPhar::BZ2extension此参数用于覆盖 转换后的存档。请注意，所有基于 zip 和 tar 的 phar 存档都必须包含其文件扩展名，以便作为 法尔档案。
.phar如果转换为基于 phar 的存档，则默认扩展名为 、 或，具体取决于指定的压缩。对于基于 tar 的 phar 存档， 默认扩展名为 、 、 和。对于基于 zip 的 phar 存档， 默认扩展名为 。
.phar.phar.gz.phar.bz2.phar.tar.phar.tar.gz.phar.tar.bz2.phar.zip
返回值
该方法在成功时返回一个 Phar 对象， 或失败时为 null。
错误／异常
此方法在无法时引发 BadMethodCallException 要压缩，已指定未知的压缩方法，请求的 archive 正在使用 Phar：：startBuffering（） 和 没有以 Phar：：stopBuffering（） 结束，如果禁用了写入支持，则为 UnexpectedValueException， 如果遇到任何问题，则为 PharException 在 phar 创建过程中。
更新日志 ¶
| 版本 | 说明 |
|---|---|
| 8.0.0 | format、 和 现在可为 null。compressionextension |
示例
示例 #1 A Phar：：convertToExecutable（） example
使用 Phar：：convertToExecutable（）：
<?php
try {
$tarphar = new Phar('myphar.phar.tar');
// convert it to the phar file format
// note that myphar.phar.tar is *not* unlinked
$phar = $tarphar->convertToExecutable(Phar::PHAR); // creates myphar.phar
$phar->setStub($phar->createDefaultStub('cli.php', 'web/index.php'));
// creates myphar.phar.tgz
$compressed = $phar->convertToExecutable(Phar::TAR, Phar::GZ, '.phar.tgz');
} catch (Exception $e) {
// handle the error here
}
?>参见
- Phar：：convertToData（） - 将 phar 存档转换为不可执行的 tar 或 zip 文件
- PharData：：convertToExecutable（） - 将不可执行的 tar/zip 存档转换为可执行的 phar 存档
- PharData：：convertToData（） - 将 phar 存档转换为不可执行的 tar 或 zip 文件
更多建议：