(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() y Phar::offsetSet() registran un nuevo archivo phar cada vez que son llamadas. Si las prestaciones son una preocupación, Phar::buildFromDirectory() o Phar::buildFromIterator() deberían ser utilizadas en su lugar.