PHP 8.5.0 Alpha 2 available for testing

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() 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.

Ver también

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

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top