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(字串 $localName, 資源|字串 $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
'無法修改 file.txt:', $e;
}
?>

注意事項

注意每次呼叫 PharData::addFile()PharData::addFromString()PharData::offsetSet() 時,都會儲存新的 phar 封存檔。如果擔心效能問題,則應改用 PharData::buildFromDirectory()PharData::buildFromIterator()

參見

新增註記

使用者貢獻的註記

此頁面沒有使用者貢獻的註記。
To Top