PharData::setMetadata

public PharData::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 utilizado para almacenar metadatos personalizados que describen algo acerca del archivo phar como entidad completa. `PharFileInfo::setMetadata` debe ser utilizado para metadatos específicos de ficheros. Las metadatos pueden degradar el rendimiento de carga de un archivo phar si los datos son demasiado pesados.

Las metadatos pueden ser utilizadas para especificar qué fichero dentro del archivo debe ser utilizado para cargar el archivo 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 para describir el archivo phar

## Valores devueltos

No se retorna ningún valor.

## Ejemplos

Un ejemplo con `Phar::setMetadata`

array(1) {
  ["chargement"]=>
  string(11) "fichier.php"
}