(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)
Phar::setMetadata — Define metadados do arquivo phar
Nota:
Este método requer que a configuração
phar.readonlydo php.ini seja definida como0para funcionar com objetos Phar. Caso contrário, uma exceção PharException será lançada.
Phar::setMetadata() deve ser usado para armazenar dados personalizados que descrevam algo sobre o arquivo phar como uma entidade completa. PharFileInfo::setMetadata() deve ser usado para metadados específicos do arquivo. Metadados podem reduzir o desempenho do carregamento de um arquivo phar se os dados forem grandes.
Alguns usos possíveis para metadados incluem especificar qual arquivo dentro do arquivo deve ser usado para inicialização, ou a localização de um manifesto de arquivo como o arquivo package.xml do » PEAR. No entanto, quaisquer dados úteis que descrevam o arquivo phar podem ser armazenados.
metadataQualquer variável PHP contendo informações para armazenar que descrevem o arquivo phar.
Nenhum valor é retornado.
Exemplo #1 Um exemplo de Phar::setMetadata()
<?php
// garantindo que o arquivo não existe
@unlink('novophar.phar');
try {
$p = new Phar(dirname(__FILE__) . '/novophar.phar', 0, 'novophar.phar');
$p['arquivo.php'] = '<?php echo "olá"';
$p->setMetadata(array('bootstrap' => 'arquivo.php'));
var_dump($p->getMetadata());
} catch (Exception $e) {
echo 'Não foi possível criar e/ou modificar o phar:', $e;
}
?>O exemplo acima produzirá:
array(1) {
["bootstrap"]=>
string(11) "arquivo.php"
}