PHP 8.4.2 Released!

PharData::offsetSet

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

PharData::offsetSetSet the contents of a file within the tar/zip to those of an external file or string

Descrição

public PharData::offsetSet(string $localName, resource|string $value): void

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

Parâmetros

localName

The filename (relative path) to modify in a tar or zip archive.

value

Content of the file.

Valor Retornado

No return values.

Erros/Exceções

Throws PharException if there are any problems flushing changes made to the tar/zip archive to disk.

Exemplos

Exemplo #1 A PharData::offsetSet() example

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

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

Notas

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

Veja Também

  • Phar::offsetSet() - Set the contents of an internal file to those of an external file

adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top