(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharData::offsetSet — Rellena un fichero dentro del archivo tar/zip con el contenido de un fichero externo o de un string
Es una implementación de la interfaz ArrayAccess que permite la manipulación directa del contenido de un archivo tar/zip utilizando los corchetes, operadores de acceso al array. offsetSet es utilizado para modificar un fichero existente o para añadir un nuevo fichero al archivo tar/zip.
localName
La ruta (relativa) del fichero a modificar dentro del archivo tar o zip.
value
Contenido del fichero.
No se devuelve ningún valor.
Se lanza una excepción PharException si se han encontrado problemas al escribir en el disco los cambios del archivo tar/zip.
Ejemplo #1 Un ejemplo con PharData::offsetSet()
offsetSet no debe ser accedido directamente, sino que debe ser utilizado a través
del operador []
.
<?php
$p = new PharData('/ruta/al/mon.tar');
try {
// llama a offsetSet
$p['fichero.txt'] = 'Hola';
} catch (Exception $e) {
echo 'No se puede modificar fichero.txt:', $e;
}
?>
Nota: Phar::addFile(), Phar::addFromString() and Phar::offsetSet() save a new phar archive each time they are called. If performance is a concern, Phar::buildFromDirectory() or Phar::buildFromIterator() should be used instead.