PharFileInfo::setMetadataУстановка метаданных для конкретного файла
&reftitle.description;
publicvoidPharFileInfo::setMetadatamixedmetadataPharFileInfo::setMetadata следует использовать для сохранения
метаданных конкретного файла, которые нельзя хранить внутри самого файла,
поскольку, если данных много, либо в принципе много файлов с метаданными - это
значительно замедляет загрузку phar-архива. Важно помнить, что phar-архивы
из коробки поддерживают права на файлы и их можно задать с помощью метода
PharFileInfo::chmod. Так как эта функциональность изменяет
phar-архив, необходимо, чтобы опция phar.readonly
была отключена, иначе внести изменения в архив Phar не
получится. На архивы PharData ограничение на запись не
распространяется.
Метаданные файлов можно использовать, например, для указания, какие
права надо назначить файлу при экспорте его на диск, или для указания MIME-типа,
который он возвращает. В общем - любая полезная информация, которой не место
внутри самого файла.
&reftitle.parameters;
metadata
Любая переменная PHP, содержащая необходимую информацию
&reftitle.returnvalues;
&return.void;
&reftitle.examples;
Пример использования PharFileInfo::setMetadata
setMetadata(array('user' => 'bill', 'mime-type' => 'text/plain'));
var_dump($p['file.txt']->getMetaData());
} catch (Exception $e) {
echo 'Не удалось создать/изменить phar: ', $e;
}
?>
]]>
&example.outputs;
string(4) "bill"
["mime-type"]=>
string(10) "text/plain"
}
]]>
&reftitle.seealso;
PharFileInfo::hasMetadataPharFileInfo::getMetadataPharFileInfo::delMetadataPhar::setMetadataPhar::hasMetadataPhar::getMetadata