(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharData::offsetSet — Define o conteúdo de um arquivo dentro do tar/zip para o de um arquivo externo ou string
Esta é uma implementação da interface ArrayAccess que permite a manipulação direta do conteúdo de um arquivo tar/zip usando colchetes de acesso a arrays. offsetSet é usado para modificar um arquivo existente ou adicionar um novo arquivo a um arquivo tar/zip.
localNameO nome do arquivo (caminho relativo) a ser modificado em um arquivo tar ou zip.
valueConteúdo do arquivo.
Sem valores de retorno.
Lança PharException se houver algum problema ao liberar as alterações feitas no arquivo tar/zip para o disco.
Exemplo #1 Um exemplo de PharData::offsetSet()
offsetSet não deve ser acessado diretamente, mas sim usado
por meio de acesso a array com o operador [].
<?php
$p = new PharData('/caminho/para/meu.tar');
try {
// chama offsetSet
$p['arquivo.txt'] = 'Olá mundo';
} catch (Exception $e) {
echo 'Não foi possível modificar arquivo.txt:', $e;
}
?>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.