2024 日本 PHP 研討會

PharData::setMetadata

(沒有版本資訊,可能只在 Git 中)

PharData::setMetadata設定 phar 封存中繼資料

說明

public PharData::setMetadata(混合 $metadata):

注意事項:

這個方法需要將 php.ini 設定 phar.readonly 設為 0,才能作用於 Phar 物件。否則,會拋出 PharException 異常。

應該使用 Phar::setMetadata() 來儲存描述整個 phar 封存檔的客製化資料。 PharFileInfo::setMetadata() 應該用於檔案特定的中繼資料。如果資料量很大,中繼資料可能會降低載入 phar 封存檔的效能。

中繼資料的一些可能用途包括指定封存檔中哪個檔案應該用於啟動封存檔,或者檔案清單的位置,例如 » PEAR 的 package.xml 檔案。然而,任何描述 phar 封存檔的有用資料都可以儲存。

參數

metadata

任何包含要儲存的描述 phar 封存檔資訊的 PHP 變數

回傳值

無回傳值。

範例

範例 #1 Phar::setMetadata() 範例

<?php
// 確保它不存在
@unlink('brandnewphar.phar');
try {
$p = new Phar(dirname(__FILE__) . '/brandnewphar.phar', 0, 'brandnewphar.phar');
$p['file.php'] = '<?php echo "hello"';
$p->setMetadata(array('bootstrap' => 'file.php'));
var_dump($p->getMetadata());
} catch (
Exception $e) {
echo
'無法建立及/或修改 phar:', $e;
}
?>

上述範例將輸出

array(1) {
  ["bootstrap"]=>
  string(8) "file.php"
}

另請參閱

新增註記

使用者貢獻的註記

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