PHP8 PharData::convertToExecutable
(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::PHAR
Phar::TAR
Phar::ZIP
compression
这应该是没有完整存档的档案之一 压缩,用于基于 zlib 的压缩和基于 bzip 的压缩。
Phar::NONE
Phar::GZ
Phar::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.0 | format 、 和 现在可为 null。compression localName |
示例
示例 #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 文件
更多建议: