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

注意:此方法需要 将 中的 设为 以适合 Phar 对象. 否则, 将抛出PharException.php.iniphar.readonly0

此方法用于将不可执行的 tar 或 zip 存档转换为 可执行 PHAR 存档。三种可执行文件格式中的任何一种 可以使用（phar、tar 或 zip），也可以执行整体存档压缩。

如果未指定任何更改，此方法将引发 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 PharData::convertToExecutable() example

使用 PharData：：convertToExecutable（）：

<?php
try {
    $tarphar = new PharData('myphar.tar');
    // convert it to the phar file format
    // note that myphar.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 = $tarphar->convertToExecutable(Phar::TAR, Phar::GZ, '.phar.tgz');
} catch (Exception $e) {
    // handle the error here
}
?>

参见 

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