(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)
Phar::offsetUnset — 从 Phar 中删除文件
注意:
此方法需要 php.ini 设置
phar.readonly
设置为0
才能对 Phar 对象起作用。否则,将抛出 PharException。
这是 ArrayAccess 接口的实现,允许使用数组访问括号直接操作 Phar 存档的内容。offsetUnset 用于删除现有文件,并由 unset() 语言构造调用。
localName
要修改的 Phar 中的文件名(相对路径)。
不返回值。
如果 phar.readonly 为 1
,则会抛出 BadMethodCallException,因为只有当 phar.readonly 设置为 0
时才允许修改 Phar。如果将对 Phar 存档所做的更改刷新到磁盘时遇到任何问题,则会抛出 PharException。
示例 #1 Phar::offsetUnset() 示例
<?php
$p = new Phar('/path/to/my.phar', 0, 'my.phar');
try {
// 通过调用 offsetUnset 从 my.phar 中删除 file.txt
unset($p['file.txt']);
} catch (Exception $e) {
echo '无法删除 file.txt: ', $e;
}
?>