(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)
Phar::offsetGet — 取得指定檔案的 PharFileInfo 物件
這是 ArrayAccess 介面的實作,允許使用陣列存取括號直接操作 Phar 封存的內容。 Phar::offsetGet() 用於從 Phar 封存中擷取檔案。
localName
要在 Phar 中尋找的檔案名稱(相對路徑)。
會傳回一個 PharFileInfo 物件,可用於迭代檔案的內容或擷取目前檔案的相關資訊。
如果 Phar 封存中不存在該檔案,此方法會丟出 BadMethodCallException 例外。
範例 #1 Phar::offsetGet() 範例
如同所有實作 ArrayAccess 介面的類別一樣,當使用 []
角括號運算子時,會自動呼叫 Phar::offsetGet()。
<?php
$p = new Phar(dirname(__FILE__) . '/myphar.phar', 0, 'myphar.phar');
$p['exists.txt'] = "file exists\n";
try {
// 自動呼叫 offsetGet()
echo $p['exists.txt'];
echo $p['doesnotexist.txt'];
} catch (BadMethodCallException $e) {
echo $e;
}
?>
以上範例將輸出
file exists Entry doesnotexist.txt does not exist