PHP8 PharFileInfo::setMetadata
2024-02-23 11:44 更新
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)
PharFileInfo::setMetadata — 设置与文件一起保存的特定于文件的元数据
说明
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 存档元数据
以上内容是否对您有帮助:
更多建议: