PharData::setMetadata

(没有版本信息可用,可能只存在于 Git 中)

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

描述

public PharData::setMetadata(mixed $metadata): void

注意:

此方法需要 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"
}

参见

添加说明

用户贡献的说明

此页面没有用户贡献的说明。
To Top