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

PharFileInfo：：setMetadata（） 只能用于在文件中存储自定义数据 不能用存储在文件中的现有信息来表示。 元数据会显著降低加载 phar 的性能 如果数据很大，或者有许多包含元数据的文件，则存档。 需要注意的是，文件权限在 法尔;可以使用 PharFileInfo：：chmod（） 方法设置它们。与修改 一个 phar， 即 phar.readonly INI 变量 如果文件位于 Phar 存档中，则必须关闭才能成功。PharData 存档中的文件没有 此限制。

元数据的一些可能用途包括传递应设置的用户/组 将文件从 PHAR 提取到磁盘时。其他用途可能包括 显式指定要返回的 MIME 类型。但是，任何有用的数据 描述了一个文件，但不应包含在其中可以存储。

参数 

metadata

任何包含要与文件一起存储的信息的 PHP 变量

返回值 

没有返回值。

示例 

示例 #1 A PharFileInfo::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.txt'] = 'hello';
    $p['file.txt']->setMetadata(array('user' => 'bill', 'mime-type' => 'text/plain'));
    var_dump($p['file.txt']->getMetaData());
} catch (Exception $e) {
    echo 'Could not create/modify phar: ', $e;
}
?>

以上示例会输出：

array(2) {
  ["user"]=>
  string(4) "bill"
  ["mime-type"]=>
  string(10) "text/plain"
}

参见 

• PharFileInfo：：hasMetadata（） - 返回条目的元数据
• PharFileInfo：：getMetadata（） - 返回与文件一起保存的特定于文件的元数据
• PharFileInfo：:d elMetadata（） - 删除条目的元数据
• Phar：：setMetadata（） - 设置 phar 存档元数据
• Phar：：hasMetadata（） - 返回 phar 是否具有全局元数据
• Phar：：getMetadata（） - 返回 phar 存档元数据