PHP8 Phar::setStub
2024-02-21 14:39 更新
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)
Phar::setStub — 用于设置 Phar 存档的 PHP 加载器或引导存根
说明
public Phar::setStub(resource|string $stub, int $length = -1): bool
注意:此方法需要 将 中的 设为 以适合 Phar 对象. 否则, 将抛出PharException.php.iniphar.readonly0
此方法用于将 PHP 引导加载器存根添加到新的 Phar 存档中,或者 替换现有 Phar 存档中的加载程序存根。
每当直接包含存档时,都会使用 Phar 存档的加载器存根 如本例所示:
<?php
include 'myphar.phar';
?>
通过流包装器包含文件时,不会访问加载器,如下所示:phar
<?php
include 'phar://myphar.phar/somefile.php';
?>
参数
stub
要用作此可执行存根的字符串或开放流句柄 法尔档案。
length
返回值
成功时返回 true, 或者在失败时返回 false。
错误/异常
如果启用了 phar.readonly,则会引发 UnexpectedValueException 在php.ini。如果遇到任何问题,则抛出 PharException 刷新对磁盘的更改。
更新日志
版本 | 说明 |
---|---|
8.3.0 | 现在不推荐使用资源和 a 调用 Phar::setStub()。此类调用应替换为:length $phar->setStub(stream_get_contents($resource)); |
示例
示例 #1 A Phar::setStub() example
<?php
try {
$p = new Phar(dirname(__FILE__) . '/brandnewphar.phar', 0, 'brandnewphar.phar');
$p['a.php'] = '<?php var_dump("Hello");';
$p->setStub('<?php var_dump("First"); Phar::mapPhar("brandnewphar.phar"); __HALT_COMPILER(); ?>');
include 'phar://brandnewphar.phar/a.php';
var_dump($p->getStub());
$p['b.php'] = '<?php var_dump("World");';
$p->setStub('<?php var_dump("Second"); Phar::mapPhar("brandnewphar.phar"); __HALT_COMPILER(); ?>');
include 'phar://brandnewphar.phar/b.php';
var_dump($p->getStub());
} catch (Exception $e) {
echo 'Write operations failed on brandnewphar.phar: ', $e;
}
?>
以上示例会输出:
string(5) "Hello" string(82) "<?php var_dump("First"); Phar::mapPhar("brandnewphar.phar"); __HALT_COMPILER(); ?>" string(5) "World" string(83) "<?php var_dump("Second"); Phar::mapPhar("brandnewphar.phar"); __HALT_COMPILER(); ?>"
参见
- Phar::getStub() - 返回 Phar 存档的 PHP 加载器或引导存根
- Phar::createDefaultStub() - 创建特定于 phar 文件格式的存根
以上内容是否对您有帮助:
更多建议: