PHP Conference Japan 2024

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

文件的内容。

返回值

无返回值。

错误/异常

如果将对 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()

参见

添加注释

用户贡献注释

此页面没有用户贡献的注释。
To Top