« PharFileInfo::getContent
PharFileInfo::getPharFlags »

PharFileInfo::getMetadata

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)

PharFileInfo::getMetadata — ファイルとともに保存されている、ファイル固有のメタデータを返す

説明

public function PharFileInfo::getMetadata(array $unserializeOptions = []): mixed

Phar アーカイブ内で、このファイル用のマニフェストに保存されたメタデータを返します。

パラメータ

戻り値

ファイルのメタデータとして保存されている、シリアライズ可能な任意の PHP 変数を返します。 メタデータが保存されていない場合は null を返します。

変更履歴

バージョン 説明
8.0.0 引数 unserializeOptions が追加されました。

例

例1 PharFileInfo::getMetadata() の例

<?php
// 確実に消しておきます
@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 'brandnewphar.phar を作成/変更できません: ', $e;
}
?>

上の例の出力は以下となります。

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

参考

関連キーワード:
メタデータ   PharFileInfo   phar   getMetadata   Phar   固有   brandnewphar   アーカイブ   setMetadata   unserializeOptions   user   bill   mime   type   text   plain   hasMetadata   エントリ   getContent   getPharFlags   mixed   マニフェスト   シリアライズ   任意   変数
関連する関数・ページ:
pharfileinfo.setmetadata   pharfileinfo.hasmetadata   pharfileinfo.delmetadata   phar.getmetadata   phar.setmetadata   phardata.setmetadata