2024 PHP 日本大会

Phar::setDefaultStub

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

Phar::setDefaultStub用于将 Phar 存档的 PHP 加载器或引导程序存根设置为默认加载器

描述

public Phar::setDefaultStub(?string $index = null, ?string $webIndex = null): true

注意:

此方法需要 php.ini 设置 phar.readonly0 才能对 Phar 对象起作用。否则,将抛出 PharException

此方法是一个便捷方法,它结合了 Phar::createDefaultStub()Phar::setStub() 的功能。

参数

index

在命令行访问时运行的 Phar 存档中的相对路径

webIndex

通过 Web 浏览器访问时运行的 Phar 存档中的相对路径

返回值

始终返回 true

错误/异常

如果在 php.ini 中启用了 phar.readonly,则会抛出 UnexpectedValueException。如果遇到将更改刷新到磁盘的任何问题,则会抛出 PharException

变更日志

版本 描述
8.4.0 Phar::setDefaultStub() 现在暂定返回 true
8.0.0 webIndex 现在可以为空。

示例

示例 #1 一个 Phar::setDefaultStub() 示例

<?php
try {
$phar = new Phar('myphar.phar');
$phar->setDefaultStub('cli.php', 'web/index.php');
// 这与以下代码相同:
// $phar->setStub($phar->createDefaultStub('cli.php', 'web/index.php'));
} catch (Exception $e) {
// 处理错误
}
?>

参见

添加注释

用户贡献的笔记

此页面没有用户贡献的笔记。
To Top