Constantes magiques
PHP fournit un grand nombre de constantes magiques. Certaines constantes sont définies par différentes extensions, et ne seront présentes que si ces extensions sont compilées avec PHP, ou bien si l'extension a été chargée dynamiquement.
Il y a neuf constantes magiques qui changent suivant l'emplacement où
elles sont utilisées.
Par exemple, la valeur de __LINE__ dépend
de la ligne où vous l'utilisez dans votre script.
Toutes ces constantes "magiques" sont évaluées au moment de la compilation,
contrairement aux constantes classiques, qui sont évaluées au moment de
l'éxécution.
Ces constantes spéciales sont insensibles à la casse.
| Nom | Description |
|---|---|
__LINE__ |
La ligne courante dans le fichier. |
__FILE__ |
Le chemin complet et le nom du fichier courant avec les liens symboliques résolus. Si utilisé pour une inclusion, le nom du fichier inclus est retourné. |
__DIR__ |
Le dossier du fichier. Si utilisé dans une inclusion, le dossier du fichier inclus sera retourné. C'est l'équivalent de dirname(__FILE__). Ce nom de dossier ne contiendra pas de slash final, sauf si c'est le dossier racine. |
__FUNCTION__ |
Le nom de la fonction. |
__CLASS__ |
Le nom de la classe courante. Le nom de la classe contient l'espace de nom dans lequel cette classe a été déclarée (i.e. Foo\Bar). Notez que depuis PHP 5.4, __CLASS__ fonctionne aussi dans les traits. Lorsqu'elle est utilisée dans une méthode de trait, __CLASS__ est le nom de la classe dans laquelle le trait est utilisé. |
__TRAIT__ |
Le nom du trait. Le nom du trait inclut l'espace de nom dans lequel il a été déclaré (e.g. Foo\Bar). |
__METHOD__ |
Le nom de la méthode courante. |
__NAMESPACE__ |
Le nom de l'espace de noms courant. |
ClassName::class |
Le nom entièrement qualifié de la classe. Voir aussi ::class. |
Voir aussi get_class(), get_object_vars(), file_exists() et function_exists().
Historique
| Version | Description |
|---|---|
| 5.5.0 |
Ajout de la constante magique ::class
|
| 5.4.0 |
Ajout de la constante __TRAIT__
|
| 5.3.0 |
Ajout des constantes __DIR__ et
__NAMESPACE__
|
| 5.0.0 |
Ajout de la constante __METHOD__
|
| 5.0.0 | Avant cette version, les valeurs de quelques constantes magiques étaient toujours en minuscule. Toutes sont désormais insensibles à la casse (contiennent les noms tels qu'ils ont été déclarés). |
| 4.3.0 |
Ajout des constantes __FUNCTION__
et __CLASS__
|
| 4.0.2 |
La constante __FILE__ contient toujours un
chemin absolu avec les liens sympboliques résolus, alors que dans les
anciennes versions et dans quelques circonstances, elle pouvait
contenir un chemin relatif
|
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-language.constants.predefined.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.
