(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::createDefaultStub — Crée un conteneur de chargement d'une archive Phar
Description
final public static
Phar::createDefaultStub(?string
$index
=
null
, ?string
$webIndex
=
null
): string
Les archives Phar contiennent un chargeur ou un conteneur écrit en PHP qui est
exécuté quand l'archive est exécutée soit par une inclusion
<?php
include 'monphar.phar';
?>
ou par une simple exécution :
php monphar.phar
Cette méthode fournit un moyen simple et facile de créer un conteneur qui lancera
un fichier de démarrage à partir de l'archive phar. En plus, des fichiers différents
peuvent être spécifiés pour exécuter l'archive à partir de la ligne de commande ou d'un
serveur web. Le conteneur de chargement appelle alors phar::interceptFileFuncs()
pour permettre l'empaquetage facile d'applications PHP accédant au système de fichiers.
Si l'extension phar n'est pas présente, le conteneur de chargement extraira l'archive phar
vers un répertoire temporaire et traitera les fichiers. Une fonction d'extinction effacera les
fichier temporaires à la fin.
Liste de paramètres
-
index
-
Chemin relatif au sein de l'archive phar à exécuter en cas d'accès à partir de la ligne de commande
-
webIndex
-
Chemin relatif au sein de l'archive phar à exécuter en cas d'accès à partir d'un navigateur
Valeurs de retour
Retourne une chaîne de caractères contenant un conteneur de chargement personnalisé
qui permet à l'archive Phar créée de fonctionner avec ou sans l'extension Phar
d'activée.
Erreurs / Exceptions
Lève une exception UnexpectedValueException si un des paramètres est plus long
que 400 octets.
Historique
Exemples
Exemple #1 Exemple avec phar::createDefaultStub()
<?php
try {
$phar = new Phar('monphar.phar');
$phar->setStub($phar->createDefaultStub('cli.php', 'web/index.php'));
} catch (Exception $e) {
// traite les erreurs
}
?>
Voir aussi
- phar::setStub() - Utilisé pour spécifier le chargeur PHP ou le conteneur de chargement d'une archive Phar
- phar::getStub() - Retourne le chargeur PHP ou le conteneur de chargement d'une archive Phar