PharData::addFromString

Add a file from a string to the tar/zip archive

&reftitle.description; public `void` `PharData::addFromString` `string` `localName` `string` `contents`

With this method, any string can be added to the tar/zip archive. The file will be stored in the archive with `localname` as its path. This method is similar to `ZipArchive::addFromString`.

&reftitle.parameters;

`localName`

- Path that the file will be stored in the archive.

`contents`

- The file contents to store

&reftitle.returnvalues;

no return value, exception is thrown on failure.

&reftitle.examples;

### A `PharData::addFromString` example

    <?php
    try {
        $a = new PharData('/path/to/my.tar');

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

        // to add contents from a stream handle for large files, use offsetSet()
        $c = fopen('/path/to/hugefile.bin');
        $a['largefile.bin'] = $c;
        fclose($c);
    } catch (Exception $e) {
        // handle errors here
    }
    ?>

&reftitle.notes; &phardata.note.performance;
&reftitle.seealso;

- `PharData::offsetSet`
- `Phar::addFromString`
- `PharData::addFile`
- `PharData::addEmptyDir`