Fija las metadatos del archivo

# PharData::setMetadata

(No version information available, might only be in Git)

PharData::setMetadata — Fija las metadatos del archivo

### Descripción

public function PharData::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 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. 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

Ejemplo #1 Un ejemplo con Phar::setMetadata()

    <?php
    // se asegura de que el phar no exista
    @unlink('nouveauphar.phar');
    try {
        $p = new Phar(dirname(__FILE__) . '/nouveauphar.phar', 0, 'nouveauphar.phar');
        $p['fichier.php'] = '<?php echo "salut"';
        $p->setMetadata(array('chargement' => 'fichier.php'));
        var_dump($p->getMetadata());
    } catch (Exception $e) {
        echo 'No puede crear/modificar el phar:', $e;
    }
    ?>

El ejemplo anterior mostrará:

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

### Ver también

- Phar::getMetadata() - Devuelve las metadatos del archivo phar
- Phar::delMetadata() - Elimina los metadatos globales del phar
- Phar::hasMetadata() - Determina si el phar contiene o no metadatos

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open