PHP8 PharData::convertToExecutable

2024-02-22 11:47 更新

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)

PharData::convertToExecutable — 将不可执行的 tar/zip 存档转换为可执行的 phar 存档

说明

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 创建过程中。

更新日志 

版本说明
8.0.0format、 和 现在可为 null。compressionlocalName

示例 

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


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号