(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) {
// 處理錯誤
}
?>