(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任何包含要存储的描述 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"
}