(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)
Phar::setMetadata — 设置 phar 存档元数据
注意:
此方法需要 php.ini 设置
phar.readonly被设置为0才能对 Phar 对象起作用。否则，将抛出 PharException。
Phar::setMetadata() 应该用于存储自定义数据，这些数据描述了 phar 存档作为完整实体的一些内容。 PharFileInfo::setMetadata() 应该用于特定于文件的元数据。如果数据量很大，元数据会降低加载 phar 存档的性能。
元数据的一些可能用途包括指定存档中哪个文件应该用于启动存档，或文件清单的位置，例如 » PEAR 的 package.xml 文件。但是，可以存储任何描述 phar 存档的有用数据。
metadata任何包含要存储信息的 PHP 变量，该信息描述 phar 存档
不返回值。
示例 #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"
}