array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'phardata.offsetset.php', 1 => 'PharData::offsetSet', 2 => 'Define o conteúdo de um arquivo dentro do tar/zip para o de um arquivo externo ou string', ), 'up' => array ( 0 => 'class.phardata.php', 1 => 'PharData', ), 'prev' => array ( 0 => 'phardata.iswritable.php', 1 => 'PharData::isWritable', ), 'next' => array ( 0 => 'phardata.offsetunset.php', 1 => 'PharData::offsetUnset', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/phar/PharData/offsetSet.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

PharData::offsetSet

(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

Descrição

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

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.

Parâmetros

localName

O nome do arquivo (caminho relativo) a ser modificado em um arquivo tar ou zip.

value

Conteúdo do arquivo.

Valor Retornado

Sem valores de retorno.

Erros/Exceções

Lança PharException se houver algum problema ao liberar as alterações feitas no arquivo tar/zip para o disco.

Exemplos

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;
}
?>

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