Adiciona um arquivo a partir de uma string ao arquivo phar

# Phar::addFromString

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)

Phar::addFromString — Adiciona um arquivo a partir de uma string ao arquivo phar

### Descrição

public function Phar::addFromString(string `$localName`, string `$contents`): 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.

Com este método, qualquer string pode ser adicionada ao arquivo phar. O arquivo será armazenado no arquivo com `localname` como seu caminho. Este método é semelhante a ZipArchive::addFromString().

### Parâmetros

`localName`

  Caminho onde o arquivo será armazenado no arquivo compactado.

`contents`

  O conteúdo do arquivo a ser armazenado

### Valor Retornado

Nenhum valor de retorno, exceção é lançada em caso de falha.

### Exemplos

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

    <?php
    try {
        $a = new Phar('/path/to/phar.phar');

        $a->addFromString('path/to/file.txt', 'my simple file');
        $b = $a['path/to/file.txt']->getContent();

        // para adicionar conteúdo de um identificador de fluxo para arquivos grandes, use offsetSet()
        $c = fopen('/path/to/hugefile.bin');
        $a['largefile.bin'] = $c;
        fclose($c);
    } catch (Exception $e) {
        // manipula erros aqui
    }
    ?>

### Notas

> Nota: Phar::addFile(), Phar::addFromString() e Phar::offsetSet() salvam um novo arquivo phar cada vez que são chamadas. Se o desempenho for uma preocupação, Phar::buildFromDirectory() ou Phar::buildFromIterator() devem ser usadas.

### Veja Também

- Phar::offsetSet() - Define o conteúdo de um arquivo interno para o de um arquivo externo
- PharData::addFromString() - Adiciona um arquivo de uma string ao arquivo tar/zip
- Phar::addFile() - Adiciona um arquivo do sistema de arquivos ao arquivo phar
- Phar::addEmptyDir() - Adiciona um diretório vazio ao arquivo phar

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