PHP8 Phar::setMetadata
（PHP 5 >= 5.3.0， PHP 7， PHP 8， PECL phar >= 1.0.0）
Phar：：setMetadata — 设置 phar 存档元数据
说明
public Phar::setMetadata(mixed $metadata): void注意:此方法需要 将 中的 设为 以适合 Phar 对象. 否则, 将抛出PharException.php.iniphar.readonly0
Phar：：setMetadata（） 应该用于存储自定义数据 这描述了 Phar 档案作为一个完整实体的一些内容。PharFileInfo：：setMetadata（） 应用于特定于文件的元数据。 如果数据很大，元数据可能会降低加载 phar 存档的性能。
元数据的一些可能用途包括指定存档中的哪个文件 应用于引导存档或文件清单的位置 喜欢 » PEAR的package.xml文件。 但是，可以存储描述 phar 存档的任何有用数据。
参数
metadata任何包含要存储的信息的 PHP 变量，用于描述 phar 存档
返回值
没有返回值。
示例
示例 #1 A Phar：：setMetadata（） example
<?php
// make sure it doesn't exist
@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 'Could not create and/or modify phar:', $e;
}
?>以上示例会输出：
array(1) {
["bootstrap"]=>
string(8) "file.php"
}
参见
- Phar：：getMetadata（） - 返回 phar 存档元数据
- Phar：:d elMetadata（） - 删除 phar 的全局元数据
- Phar：：hasMetadata（） - 返回 phar 是否具有全局元数据