Phar::setMetadata

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

> [!NOTE]
> 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](https://pear.php.net/). 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

Un ejemplo con `Phar::setMetadata`

array(1) {
  ["cargador"]=>
  string(11) "fichero.php"
}