array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'phar.setmetadata.php', 1 => 'Phar::setMetadata', 2 => 'Establece las metadatos del archivo phar', ), 'up' => array ( 0 => 'class.phar.php', 1 => 'Phar', ), 'prev' => array ( 0 => 'phar.setdefaultstub.php', 1 => 'Phar::setDefaultStub', ), 'next' => array ( 0 => 'phar.setsignaturealgorithm.php', 1 => 'Phar::setSignatureAlgorithm', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/phar/Phar/setMetadata.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Phar::setMetadata

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)

Phar::setMetadata — Establece las metadatos del archivo phar

Descripción

public Phar::setMetadata(mixed $metadata): void

Nota:

Este método requiere que la variable de configuración INI phar.readonly esté definida a 0 para 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.

Parámetros

metadata

Cualquier variable PHP que contenga información a almacenar y que describa el archivo phar

Valores devueltos

No se retorna ningún valor.

Ejemplos

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"
}

Ver también