Define metadados do arquivo phar

# PharData::setMetadata

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

PharData::setMetadata — Define metadados do arquivo phar

### Descrição

public function PharData::setMetadata(mixed `$metadata`): void

> Nota: Este método requer que a configuração `phar.readonly` do php.ini seja definida como `0` para funcionar com objetos Phar. Caso contrário, uma exceção PharException será lançada.

Phar::setMetadata() deve ser usado para armazenar dados personalizados que descrevam algo sobre o arquivo phar como uma entidade completa. PharFileInfo::setMetadata() deve ser usado para metadados específicos do arquivo. Metadados podem reduzir o desempenho do carregamento de um arquivo phar se os dados forem grandes.

Alguns usos possíveis para metadados incluem especificar qual arquivo dentro do arquivo deve ser usado para inicializar o arquivo, ou a localização de um manifesto de arquivo como o arquivo package.xml do » PEAR. No entanto, quaisquer dados úteis que descrevam o arquivo phar podem ser armazenados.

### Parâmetros

`metadata`

  Qualquer variável PHP contendo informações para armazenar que descrevem o arquivo phar

### Valor Retornado

Nenhum valor é retornado.

### Exemplos

Exemplo #1 Um exemplo de Phar::setMetadata()

    <?php
    // garantindo que o arquivo não existe
    @unlink('novophar.phar');
    try {
        $p = new Phar(dirname(__FILE__) . '/novophar.phar', 0, 'novophar.phar');
        $p['arquivo.php'] = '<?php echo "olá"';
        $p->setMetadata(array('bootstrap' => 'arquivo.php'));
        var_dump($p->getMetadata());
    } catch (Exception $e) {
        echo 'Não foi possível criar e/ou modificar o phar:', $e;
    }
    ?>

O exemplo acima produzirá:

    array(1) {
      ["bootstrap"]=>
      string(11) "arquivo.php"
    }

### Veja Também

- Phar::getMetadata() - Retorna metadados do arquivo phar
- Phar::delMetadata() - Exclui os metadados globais do phar
- Phar::hasMetadata() - Informa se o phar tem metadados globais

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