(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharData::offsetSet — 将 tar/zip 中文件的內容设置为外部文件或字符串的内容
这是对 ArrayAccess 接口的实现,允许使用数组访问方括号直接操作 tar/zip 存档的内容。offsetSet 用于修改现有文件或向 tar/zip 存档添加新文件。
localName
要修改的 tar 或 zip 存档中的文件名(相对路径)。
value
文件的内容。
没有返回值。
如果在将对 tar/zip 存档所做的更改刷新到磁盘时遇到任何问题,将抛出 PharException。
示例 #1 一个 PharData::offsetSet() 示例
offsetSet 不应该直接访问,而是通过使用 []
运算符进行数组访问来使用。
<?php
$p = new PharData('/path/to/my.tar');
try {
// 调用 offsetSet
$p['file.txt'] = 'Hi there';
} catch (Exception $e) {
echo 'Could not modify file.txt:', $e;
}
?>
注意: PharData::addFile()、PharData::addFromString() 和 PharData::offsetSet() 在每次调用时都会保存一个新的 phar 存档。如果性能是一个问题,则应该使用 PharData::buildFromDirectory() 或 PharData::buildFromIterator() 来代替。