(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 '無法修改 file.txt:', $e;
}
?>
注意:每次呼叫 PharData::addFile()、PharData::addFromString() 和 PharData::offsetSet() 時,都會儲存新的 phar 封存檔。如果擔心效能問題,則應改用 PharData::buildFromDirectory() 或 PharData::buildFromIterator()。