PHP8 PharData::setMetadata
(没有可用的版本信息,可能仅在 Git 中)
PharData::setMetadata — 设置 phar 存档元数据
说明
public PharData::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 是否具有全局元数据