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().
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
|