PharFileInfo::setMetadata
(PHP 5 >= 5.3.0, PHP 7, PECL phar >= 1.0.0)
PharFileInfo::setMetadata — Fixe les métadonnées spécifiques à un fichier
Description
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
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éta-données de l'archive
- 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
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-pharfileinfo.setmetadata.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
