(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 流包装器访问中引用的简写字符串。
始终返回 true。
当禁用写访问时抛出 UnexpectedValueException，如果别名已在使用或遇到任何将更改刷新到磁盘的问题时抛出 PharException。
| 版本 | 描述 |
|---|---|
| 8.4.0 | Phar::setAlias() 现在尝试返回 true。 |
示例 #1 一个 Phar::setAlias() 示例
<?php
try {
$phar = new Phar('myphar.phar');
$phar->setAlias('myp.phar');
} catch (Exception $e) {
// 处理错误
}
?>