PHP Conference Japan 2024

PharData::setMetadata

(无版本信息可用,可能仅在Git中)

PharData::setMetadata设置phar存档元数据

描述

public PharData::setMetadata(混合 $metadata): void

注意:

此方法需要php.ini 设置phar.readonly0才能对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"
}

参见

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top