PharFileInfo::setMetadata

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

`PharFileInfo::setMetadata` debe ser utilizada únicamente para almacenar datos personalizados en un fichero que no pueden ser almacenados con las informaciones normalmente almacenadas con el fichero. Las metadatos pueden degradar el rendimiento de carga de un archivo phar si los datos son demasiado pesados o si hay muchos ficheros con metadatos. Es importante señalar que los permisos de ficheros son soportados nativamente en un phar; es posible fijarlos con el método `PharFileInfo::chmod`. Al igual que con todas las funcionalidades que modifican el contenido del phar, la variable INI [phar.readonly](#ini.phar.readonly) debe estar a off para tener éxito si el fichero está dentro de un archivo `Phar`. Los ficheros dentro de archivos `PharData` no tienen esta restricción.

Un uso posible de las metadatos es el paso de un usuario/grupo que debería ser utilizado cuando un fichero es extraído del phar hacia el disco. También puede especificarse un tipo MIME a devolver. En general, puede almacenarse cualquier dato útil que describa un fichero pero que no pueda ser inscrito directamente en él.

## Parámetros

`metadata`  
Cualquier variable PHP que contenga información a almacenar aparte del fichero

## Valores devueltos

No se retorna ningún valor.

## Ejemplos

Un ejemplo con `PharFileInfo::setMetadata`

array(2) {
  ["utilisateur"]=>
  string(7) "PhilDaiguille"
  ["mime-type"]=>
  string(10) "text/plain"
}