creationdev

Documentation

Conception web microsite

1000$ CAD

Conception web ecommerce

2500$ CAD

Référencement web organique

300$ CAD

Conception d'application web

100$ CAD

Référencement web optimisé

500$ CAD

Formation référencement web

100$ CAD

Référencement web stratégique

1000$ CAD

Conception web extra

5000$ CAD

Référencement web expert

750$ CAD

Conception web standard

2500$ CAD

Méthode

PharFileInfo::setMetadata

Contact

PharFileInfo::setMetadata

26 déc. 2018

12 fois

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

PharFileInfo::setMetadata — Fixe les métadonnées spécifiques à un fichier

Description

public PharFileInfo::setMetadata(mixed $metadata): void

PharFileInfo::setMetadata() ne doit être utilisée que pour stocker des données personnalisées dans un fichier qui ne peuvent pas l'être avec des informations normalement stockées avec le fichier. Les métadonnées peuvent dégrader les performances de chargement d'une archive phar si les données sont trop lourdes ou s'il y a beaucoup de fichiers avec des métadonnées. Il est important de noter que les permissions de fichiers sont supportées nativement dans un phar; il est possible de les fixer avec la méthode pharfileinfo::chmod(). Comme avec toutes les fonctionnalités qui modifient le contenu du phar, la variable INI phar.readonly doit être à off pour réussir si le fichier est au sein d'une archive Phar. Les fichiers au sein d'archives PharData n'ont pas cette restriction.

Une utilisation possible des métadonnées est le passage d'un utilisateur/groupe qui devrait être utilisé quand un fichier est extrait du phar vers le disque. On peut aussi spécifier un type MIME à retourner. De manière générale, on peut stocker toute donnée utile qui décrit un fichier mais qui ne peut pas y être inscrite directement.

Liste de paramètres

metadata: Toute variable PHP contenant des informations à stocker à part du fichier

Valeurs de retour

Aucune valeur n'est retournée.

Exemples

Exemple #1 Un exemple avec PharFileInfo::setMetadata()

<?php
// on s'assure que le phar n'existe pas déjà
@unlink('nouveauphar.phar');
try {
    $p = new Phar(dirname(__FILE__) . '/nouveauphar.phar', 0, 'nouveauphar.phar');
    $p['fichier.txt'] = 'salut';
    $p['fichier.txt']->setMetadata(array('utilisateur' => 'Yannick', 'mime-type' => 'text/plain'));
    var_dump($p['fichier.txt']->getMetadata());
} catch (Exception $e) {
    echo 'Ne peut pas créer/modifier le phar : ', $e;
}
?>

L'exemple ci-dessus va afficher :

array(2) {
  ["utilisateur"]=>
  string(7) "Yannick"
  ["mime-type"]=>
  string(10) "text/plain"
}

Voir aussi

pharfileinfo::hasMetadata() - Retourne les méta-données de l'entrée
pharfileinfo::getMetadata() - Retourne les méta-données spécifiques attachées à un fichier
PharFileInfo::delMetadata() - Efface les métadonnées de l'entrée
phar::setMetadata() - Fixe les métadonnées de l'archive phar
phar::hasMetadata() - Détermine si le phar a ou non des méta-données
phar::getMetadata() - Retourne les méta-données de l'archive phar