Phar::addFromString

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

Phar::addFromString — Añ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 variable de configuración INI phar.readonly esté definida a 0 para funcionar con los objetos Phar. De lo contrario, se lanzará una excepción 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() 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
PharData::addFromString() - Añade un fichero a partir de un string al archivo tar/zip
Phar::addFile() - Añade un fichero del sistema de ficheros al archivo phar
Phar::addEmptyDir() - Añade un directorio vacío al archivo phar