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::ZIP

compression

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

extension

此参数用于覆盖 转换后的存档。请注意，所有基于 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 创建过程中。

更新日志 ¶

示例

示例 #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 文件