Ajoute un fichier depuis une chaîne de caractères à l'archive phar

# Phar::addFromString

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

Phar::addFromString — Ajoute un fichier depuis une chaîne de caractères à l'archive phar

### Description

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

> Note: Cette méthode nécessite que la variable de configuration INI `phar.readonly` soit définie à `0` pour fonctionner avec les objets Phar. Sinon, une exception PharException sera lançée.

Grâce à cette méthode, toute chaîne peut être ajoutée à l'archive phar. Le fichier sera stocké dans l'archive avec `localname` en tant que chemin. Cette méthode est identique à ZipArchive::addFromString().

### Liste de paramètres

`localName`

  Chemin dans lequel le fichier sera stocké dans l'archive.

`contents`

  Le contenu de fichier à stocker

### Valeurs de retour

Pas de valeur de retour, une exception est levée en cas d'échec.

### Exemples

Exemple #1 Un exemple avec Phar::addFromString()

    <?php
    try {
        $a = new Phar('/chemin/vers/phar.phar');

        $a->addFromString('chemin/vers/fichier.txt', 'mon fichier simple');
        $b = $a['chemin/vers/fichier.txt']->getContent();

        // pour ajouter du contenu à partir d'un descripteur de flux pour des gros fichiers, utiliser offsetSet()
        $c = fopen('/chemin/vers/grosfichier.bin');
        $a['grosfichier.bin'] = $c;
        fclose($c);
    } catch (Exception $e) {
        // traite les erreurs ici
    }
    ?>

### Notes

> Note: Phar::addFile(), Phar::addFromString() et Phar::offsetSet() enregistre une nouvelle archive phar à chaque fois qu'elles sont appelées. Si les performances sont une préoccupation, Phar::buildFromDirectory() ou Phar::buildFromIterator() devraient être utilisé à la place.

### Voir aussi

- Phar::offsetSet() - Met le contenu d'un fichier interne à l'archive à l'identique du contenu d'un fichier externe
- PharData::addFromString() - Ajoute un fichier à partir d'une chaîne de caractères à l'archive tar/zip
- Phar::addFile() - Ajoute un fichier du système de fichiers à l'archive phar
- Phar::addEmptyDir() - Ajoute un répertoire vide à l'archive phar

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