PHP8 PharData::offsetSet
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharData::offsetSet — 将 tar/zip 中文件的内容设置为外部文件或字符串的内容
说明
public PharData::offsetSet(string $localName, resource|string $value): void
这是 ArrayAccess 接口的实现,允许 直接操作 tar/zip 存档的内容 阵列访问括号。offsetSet 用于修改 现有文件,或将新文件添加到 tar/zip 存档。
参数
localName
要在 tar 或 zip 存档中修改的文件名(相对路径)。
value
文件的内容。
返回值
无返回值。
错误/异常
如果刷新出现任何问题,则引发 PharException 对磁盘的 tar/zip 存档所做的更改。
示例
示例 #1 A PharData::offsetSet() example
不应直接访问 offsetSet,而应使用 通过与操作员的阵列访问。[]
<?php
$p = new PharData('/path/to/my.tar');
try {
// calls 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()。
参见
- Phar::offsetSet() - 将内部文件的内容设置为外部文件的内容