creationdev

Documentation

Référencement web expert

750$ CAD

Référencement web organique

300$ CAD

Formation référencement web

100$ CAD

Référencement web optimisé

500$ CAD

Conception web ecommerce

2500$ CAD

Conception d'application web

100$ CAD

Conception web extra

5000$ CAD

Conception web standard

2500$ CAD

Référencement web stratégique

1000$ CAD

Conception web microsite

1000$ CAD

Méthode

PharData::addFile

Contact

PharData::addFile

26 déc. 2018

13 fois

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

PharData::addFile — Ajoute un fichier du système de fichiers à l'archive tar/zip

Description

public PharData::addFile(string $filename, ?string $localName = null): void

Avec cette méthode, n'importe quel fichier ou URL peut être ajouté à l'archive tar/zip. Si le second paramètre optionnel localname est spécifié, le fichier sera stocké dans l'archive avec ce nom, sans quoi le paramètre file est utilisé comme chemin vers lequel stocker le fichier au sein de l'archive. Les URL doivent avoir un nom local sans quoi une exception est levée. Cette méthode est identique à ZipArchive::addFile().

Liste de paramètres

filename: Chemin relatif ou absolu vers un fichier du disque à ajouter à l'archive phar.
localName: Chemin vers lequel le fichier sera stocké au sein de l'archive.

Valeurs de retour

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

Historique

Version	Description
8.0.0	`localName` est désormais nullable.

Exemples

Exemple #1 Un exemple avec phardata::addFile()

<?php
try {
    $a = new PharData('/chemin/vers/mon.tar');

    $a->addFile('/chemin/complet/vers/fichier');
    // montre comment le fichier est stocké
    $b = $a['chemin/complet/vers/fichier']->getContent();

    $a->addFile('/chemin/complet/vers/fichier', 'mon/fichier.txt');
    $c = $a['mon/fichier.txt']->getContent();

    // montre l'utilisation des URLs
    $a->addFile('http://www.exemple.com', 'exemple.html');
} catch (Exception $e) {
    // les erreurs sont traitées ici
}
?>

Notes

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

Voir aussi

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