Añade un fichero desde un string al archivo phar

# 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 function 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open