PHP8 Phar::loadPhar
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)
Phar::loadPhar — 加载任何带有别名的 phar 存档
说明
final public static Phar::loadPhar(string $filename, ?string $alias = null): bool
这可用于读取外部 Phar 存档的内容。这 对于将别名分配给 phar 最有用,以便后续引用 到 phar 可以使用较短的别名,或者用于加载 Phar 存档 仅包含数据,不打算在 PHP 脚本中执行/包含。
参数
filename
要打开的 Phar 存档的完整路径或相对路径
alias
可用于引用 phar 存档的别名。注意 许多 phar 存档在 phar 存档,如果出现以下情况,将抛出 PharException 在这种情况下,将指定一个新别名。
返回值
成功时返回 true, 或者在失败时返回 false。
错误/异常
如果传入别名并且 phar 存档,则会抛出 PharException 已有显式别名
示例
示例 #1 A Phar::loadPhar() example
Phar::loadPhar 可以在任何地方用于加载外部 Phar 存档,而 Phar::mapPhar 应该用于 Phar 的加载器存根中。
<?php
try {
Phar::loadPhar('/path/to/phar.phar', 'my.phar');
echo file_get_contents('phar://my.phar/file.txt');
} catch (PharException $e) {
echo $e;
}
?>
参见
- Phar::mapPhar() - 读取当前执行的文件 (phar) 并注册其清单