(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)
Phar::setMetadata — Establecer la metainformación de un archivo phar
Nota:
Este método requiere que la opción de php.ini
phar.readonlyesté establecida a0para que trabaje con objetos Phar. De otra manera, se lanzará una excepción de tipo PharException.
Phar::setMetadata() debería usarse para almacenar información personalizada que describa algo sobre el archivo phar como una entidad completa. PharFileInfo::setMetadata() debería usarse para metainformación específica de cada fichero. La metainformación puede ralentizar la velocidad de carga de un archivo phar si la información es grande.
Algunos posibles usos para la metainformación incluyen especificar qué fichero dentro del archivo debería usarse para cargar el archivo, o la ubicación de un fichero de manifiesto como el fichero package.xml de » PEAR. Sin embargo, se puede almacenar cualquier información útil que describa el archivo phar.
metadataCualquier variable de PHP que contenga la información a almacenar que describa el archivo phar
No devuelve ningún valor.
Ejemplo #1 Un ejemplo de Phar::setMetadata()
<?php
// asegurarse de que no existe
@unlink('nuevo_phar.phar');
try {
$p = new Phar(dirname(__FILE__) . '/nuevo_phar.phar', 0, 'nuevo_phar.phar');
$p['fichero.php'] = '<?php echo "hola"';
$p->setMetadata(array('bootstrap' => 'fichero.php'));
var_dump($p->getMetadata());
} catch (Exception $e) {
echo 'No se pudo crear y/o modificar el phar:', $e;
}
?>
El resultado del ejemplo sería:
array(1) {
["bootstrap"]=>
string(11) "fichero.php"
}