PharData::offsetSet

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

PharData::offsetSetRellena un fichero dentro del archivo tar/zip con el contenido de un fichero externo o de un string

Descripción

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

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.

Parámetros

localName

La ruta (relativa) del fichero a modificar dentro del archivo tar o zip.

value

Contenido del fichero.

Valores devueltos

No se devuelve ningún valor.

Errores/Excepciones

Se lanza una excepción PharException si se han encontrado problemas al escribir en el disco los cambios del archivo tar/zip.

Ejemplos

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

Notas

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.

Ver también

  • Phar::offsetSet() - Establece el contenido de un fichero interno en el archivo a partir del contenido de un fichero externo