(沒有版本資訊,可能只在 Git 中)
PharData::setMetadata — 設定 phar 封存中繼資料
注意事項:
這個方法需要將 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" }