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 存档元数据


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号