PHP8 Phar::offsetGet
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)
Phar::offsetGet — 获取特定文件的 PharFileInfo 对象
说明
public Phar::offsetGet(string $localName): SplFileInfo
这是 ArrayAccess 接口的实现,允许使用 阵列访问括号。使用 Phar::offsetGet() 用于从 Phar 存档中检索文件。
参数
localName
要在 Phar 中查找的文件名(相对路径)。
返回值
返回一个 PharFileInfo 对象,该对象可用于 循环访问文件的内容或检索有关当前文件的信息。
错误/异常
此方法在以下情况下引发 BadMethodCallException: 在 Phar 档案中不存在。
示例
示例 #1 Phar::offsetGet() example
与实现 ArrayAccess 接口的所有类一样,Phar::offsetGet() 是自动的 使用尖括号运算符时调用。[]
<?php
$p = new Phar(dirname(__FILE__) . '/myphar.phar', 0, 'myphar.phar');
$p['exists.txt'] = "file exists\n";
try {
// automatically calls offsetGet()
echo $p['exists.txt'];
echo $p['doesnotexist.txt'];
} catch (BadMethodCallException $e) {
echo $e;
}
?>
以上示例会输出:
file exists Entry doesnotexist.txt does not exist
参见
- Phar::offsetExists() - 确定 phar 中是否存在文件
- Phar::offsetSet() - 将内部文件的内容设置为外部文件的内容
- Phar::offsetUnset() - 从 phar 中删除文件