(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)
Phar::offsetGet — Obtient un objet PharFileInfo à partir d'un fichier
Description
public
Phar::offsetGet(string
$localName
): SplFileInfo
Liste de paramètres
-
localName
-
Le nom de fichier (en chemin relatif) à chercher dans le Phar.
Valeurs de retour
Un objet PharFileInfo est retourné et
peut être utilisé pour intégrer le contenu d'un fichier ou pour
récupérer des informations sur le fichier courant.
Erreurs / Exceptions
Cette méthode émet une exception BadMethodCallException
si le fichier n'existe pas dans l'archive Phar.
Exemples
Exemple #1 Exemple avec Phar::offsetGet()
Comme avec toutes les classes qui implémentent l'interface
ArrayAccess, Phar::offsetGet()
est automatiquement appelée quand les crochets d'accès à un tableau
sont utilisés ([]
).
<?php
$p = new Phar(dirname(__FILE__) . '/monphar.phar', 0, 'monphar.phar');
$p['existe.txt'] = "le fichier existe\n";
try {
// appelle automatiquement offsetGet()
echo $p['existe.txt'];
echo $p['nexistepas.txt'];
} catch (BadMethodCallException $e) {
echo $e;
}
?>
L'exemple ci-dessus va afficher :
le fichier existe
Entry nexistepas.txt does not exist
Voir aussi
- Phar::offsetExists() - Détermine si un fichier existe dans le phar
- Phar::offsetSet() - Met le contenu d'un fichier interne à l'archive à l'identique du contenu d'un fichier externe
- Phar::offsetUnset() - Efface un fichier d'un phar