# Phar::setMetadata

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

Phar::setMetadata — Establecer la metainformación de un archivo phar

### Descripción

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

> Nota:

> Este método requiere que la opción de php.ini `phar.readonly` esté establecida a `0` para 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.

### Parámetros

`metadata`

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

### Valores devueltos

No devuelve ningún valor.

### Ejemplos

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

### Ver también

- Phar::getMetadata() - Devolver la metainformación de un archivo phar
- Phar::delMetadata() - Eliminar la metainformación global del phar
- Phar::hasMetadata() - Devolver si el phar tiene metainformación global