(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)
Phar::setMetadata — Establece las metadatos del archivo phar
Nota:
Este método requiere que la variable de configuración INI
phar.readonlyesté definida a0para funcionar con los objetos Phar. De lo contrario, se lanzará una excepción PharException.
Phar::setMetadata() debe ser utilizada para almacenar datos personalizados que describen el archivo phar, como una entidad separada. PharFileInfo::setMetadata() debe ser utilizada para las metadatos específicas de los ficheros. Las metadatos pueden disminuir el rendimiento de carga de un archivo phar si los datos son grandes.
Un uso posible de las metadatos es la especificación de los ficheros a utilizar dentro del archivo para ejecutarlo, o la ubicación de un fichero de manifiesto como el fichero package.xml de » PEAR. En general, cualquier dato útil que describa el archivo phar puede ser almacenado.
metadataCualquier variable PHP que contenga información a almacenar y que describa el archivo phar
No se retorna ningún valor.
Ejemplo #1 Un ejemplo con Phar::setMetadata()
<?php
// se asegura de que el phar no exista ya
@unlink('nuevo.phar');
try {
$p = new Phar(dirname(__FILE__) . '/nuevo.phar', 0, 'nuevo.phar');
$p['fichero.php'] = '<?php echo "hola"';
$p->setMetadata(array('cargador' => 'fichero.php'));
var_dump($p->getMetadata());
} catch (Exception $e) {
echo 'No puede crear/modificar el phar :', $e;
}
?>El ejemplo anterior mostrará :
array(1) {
["cargador"]=>
string(11) "fichero.php"
}