PHP8 Phar::setStub
（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 文件格式的存根