(PHP >= 5.3.0, PECL phar >= 1.0.0)
Phar::setMetadata — Установить мета-данные phar-архива
Замечание:
Для корректной работы с объектами Phar этому методу необходима установка значения php.ini phar.readonly в 0. В противном случае, будет выброшено исключение PharException.
Функция Phar::setMetadata() используется для сохранения данных, характеризующих phar-архив в целом. PharFileInfo::setMetadata() используется для установки мета-данных для конкретного файла. Если мета-данных будет много, то это может снизить скорость загрузки phar-архива.
Мета-данные можно использовать, например, для указания, какой файл должен исполняться при загрузке, или для указагния местоположения манифеста, типа package.xml для модуля » PEAR. В общем, любые полезные в контексте phar-архива данные.
metadataЛюбая переменная PHP, содержащая необходимую информацию
Эта функция не возвращает значения после выполнения.
Пример #1 Пример использования Phar::setMetadata()
<?php
// удаляем, на всякий случай
@unlink('brandnewphar.phar');
try {
$p = new Phar(dirname(__FILE__) . '/brandnewphar.phar', 0, 'brandnewphar.phar');
$p['file.php'] = '<?php echo "hello"';
$p->setMetadata(array('bootstrap' => 'file.php'));
var_dump($p->getMetadata());
} catch (Exception $e) {
echo 'Could not create and/or modify phar:', $e;
}
?>
Результат выполнения данного примера:
array(1) {
["bootstrap"]=>
string(8) "file.php"
}