# Phar::addFromString

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

Phar::addFromString — Añadir 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.

Con este método, cuanquierl cadena se puede añadir al archivo phar. El fichero será almacenado en el archivo con `localname` como su ruta. Este método es similar a ZipArchive::addFromString().

### Parámetros

`localname`

  Ruta con la que 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 Un ejemplo de Phar::addFromString()

`<?php
try {
$a = new Phar('/ruta/a/phar.phar');
$a->addFromString('ruta/a/fichero.txt', 'mi sencillo fichero');
$b = $a['ruta/a/fichero.txt']->getContent();
// para añadir contenido desde un gestor de flujos para ficheros grandes, use offsetSet()
$c = fopen('/ruta/a/fichero_enorme.bin');
$a['fichero_grande.bin'] = $c;
fclose($c);
} catch (Exception $e) {
// manejar los errores aquí
}
?>`

### Ver también

- Phar::offsetSet() - Establecer el contenido de un fichero interno a aquel de un fichero externo
- PharData::addFromString() - Añadir un fichero desde el sistema de ficheros al archivo tar/zip
- Phar::addFile() - Añadir un fichero desde el sistema de ficheros al archivo phar
- Phar::addEmptyDir() - Añadir un directorio vacío al archvo phar