PHP Portal » PHP Handbuch » Phar::offsetSet

Werbung

Phar::offsetSet


(PHP >= 5.3.0, PECL phar >= 1.0.0)

Phar::offsetSetset the contents of an internal file to those of an external file

Beschreibung

void Phar::offsetSet ( string $offset , string $value )

Hinweis: Diese Methode des Phar-Objekts funktioniert nur wenn die php.ini-Einstellung phar.readonly auf 0 gesetzt ist, sonst wird eine PharException geworfen.

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.

Parameter-Liste

offset

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

value

Content of the file.

Rückgabewerte

No return values.

Fehler/Exceptions

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.

Beispiele

Beispiel #1 A Phar::offsetSet() example

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

PHP Code
1
2
3
4
5
6
7
$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; }

Siehe auch