Phar::offsetSet

Set the contents of an internal file to those of an external file

&reftitle.description; public `void` `Phar::offsetSet` `string` `localName` ``resource``string```value` &phar.write;

This is an implementation of the ArrayAccess interface allowing direct manipulation of the contents of a Phar archive using array access brackets. offsetSet is used for modifying an existing file, or adding a new file to a Phar archive.

&reftitle.parameters;

`localName`

- The filename (relative path) to modify in a Phar.

`value`

- Content of the file.

&reftitle.returnvalues;

No return values.

&reftitle.errors;

if phar.readonly is `1`, `BadMethodCallException` is thrown, as modifying a Phar is only allowed when phar.readonly is set to `0`. Throws `PharException` if there are any problems flushing changes made to the Phar archive to disk.

&reftitle.examples;

### A `Phar::offsetSet` example

offsetSet should not be accessed directly, but instead used via array access with the `[]` operator.

    <?php
    $p = new Phar('/path/to/my.phar', 0, 'my.phar');
    try {
        // calls offsetSet
        $p['file.txt'] = 'Hi there';
    } catch (Exception $e) {
        echo 'Could not modify file.txt:', $e;
    }
    ?>

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

- `Phar::offsetExists`
- `Phar::offsetGet`
- `Phar::offsetUnset`