(No version information available, might only be in Git)
PharData::setMetadata — Fixe les méta-données de l'archive
Description
public
PharData::setMetadata(mixed
$metadata
): 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.
phar::setMetadata() doit être utilisé pour stocker des méta-données personnalisées
qui décrivent quelque chose à propos de l'archive phar en tant qu'entité complète.
PharFileInfo::setMetadata() doit être utilisé pour les méta-données spécifiques aux fichiers.
Les méta-données peuvent dégrader les performances de chargement d'une archive phar si les données sont trop lourdes.
Les méta-données peuvent être utilisées pour spécifier quel fichier au sein de l'archive doit être utilisé pour
charger l'archive ou l'emplacement d'un fichier de manifeste comme le fichier package.xml de
» PEAR.
De manière générale, n'importe quelle donnée utile décrivant l'archive phar peut être stockée.
Liste de paramètres
-
metadata
-
N'importe quelle variable PHP contenant de l'information à stocker pour décrire l'archive phar
Valeurs de retour
Aucune valeur n'est retournée.
Exemples
Exemple #1 Un exemple avec phar::setMetadata()
<?php
// on s'assure que le phar n'existe pas
@unlink('nouveauphar.phar');
try {
$p = new Phar(dirname(__FILE__) . '/nouveauphar.phar', 0, 'nouveauphar.phar');
$p['fichier.php'] = '<?php echo "salut"';
$p->setMetadata(array('chargement' => 'fichier.php'));
var_dump($p->getMetadata());
} catch (Exception $e) {
echo 'Ne peut pas créer/modifier le phar:', $e;
}
?>
L'exemple ci-dessus va afficher :
array(1) {
["chargement"]=>
string(11) "fichier.php"
}
Voir aussi
- phar::getMetadata() - Retourne les méta-données de l'archive phar
- phar::delMetadata() - Efface les méta-données globales du phar
- phar::hasMetadata() - Détermine si le phar a ou non des méta-données