(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.2.1)
Phar::setAlias — 设置 Phar 归档的别名
注意:
此方法需要 php.ini 设置
phar.readonly
设置为0
才能对 Phar 对象起作用。否则,将抛出 PharException。
设置 Phar 归档的别名,并将其写入为该 Phar 归档的永久别名。别名可以在 Phar 归档内部使用,以确保无论 Phar 归档在文件系统中的位置如何,使用 phar
流包装器访问内部文件始终有效。另一种选择是依赖于 Phar 对 include 的拦截,或者使用 Phar::interceptFileFuncs() 并使用相对路径。
alias
此归档在 phar
流包装器访问中可以引用的简写字符串。
当写入访问被禁用时,抛出 UnexpectedValueException,如果别名已被使用或在将更改刷新到磁盘时遇到任何问题,则抛出 PharException。
示例 #1 Phar::setAlias() 示例
<?php
try {
$phar = new Phar('myphar.phar');
$phar->setAlias('myp.phar');
} catch (Exception $e) {
// 处理错误
}
?>