(无版本信息可用,可能仅在Git中)
PharData::setMetadata — 设置phar存档元数据
注意:
此方法需要php.ini 设置
phar.readonly
为0
才能对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" }