Phar::addFromString

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

Phar::addFromStringAñade un fichero desde un string al archivo phar

Descripción

public Phar::addFromString(string $localName, string $contents): void

Nota:

Este método requiere que la opción de php.ini phar.readonly esté establecida a 0 para que trabaje con objetos Phar. De otra manera, se lanzará una excepción de tipo PharException.

Esta función permite añadir cualquier string a un archivo phar. El fichero se almacenará en el archivo con localname como ruta. Esta función es idéntica a ZipArchive::addFromString().

Parámetros

localName

Ruta donde el fichero será almacenado en el archivo.

contents

El contenido del fichero a almacenar

Valores devueltos

No devuelve ningún valor, se lanza una excepción en caso de error.

Ejemplos

Ejemplo #1 Ejemplo con Phar::addFromString()

<?php
try {
$a = new Phar('/ruta/al/archivo.phar');

$a->addFromString('ruta/al/fichero.txt', 'mi fichero simple');
$b = $a['ruta/al/fichero.txt']->getContent();

// para añadir contenido desde un descriptor de flujo para archivos grandes, utilice offsetSet()
$c = fopen('/ruta/al/archivo_grande.bin');
$a['archivo_grande.bin'] = $c;
fclose($c);
} catch (
Exception $e) {
// manejo de errores aquí
}
?>

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