(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 opción de php.ini
phar.readonly
esté establecida a0
para que trabaje con objetos Phar. De otra manera, se lanzará una excepción de tipo 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.
metadata
Cualquier variable PHP que contenga información a almacenar y que describa el archivo phar
No devuelve 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 resultado del ejemplo sería:
array(1) { ["cargador"]=> string(11) "fichero.php" }