Il y a quelque 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 un 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'exé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, ou {closure} pour les fonctions anonymes.
|
__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).
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. |
__PROPERTY__ |
Valide uniquement à l'intérieur d'un hook de propriété. Il est égal au nom de la propriété. |
__NAMESPACE__ |
Le nom de l'espace de noms courant. |
ClassName::class |
Le nom entièrement qualifié de la classe. |
<?php
namespace My\App {
class Api {
public static fetch() {
print __FUNCTION__ . "\n"; // outputs fetch
print __METHOD__ . "\n"; // outputs My\App\Api::fetch
}
}
Api::fetch();
}
namespace {
My\App\Api::fetch();
}
?>
__METHOD__ outputs a fully qualified method name; __FUNCTION__ when used in a method, outputs just the method name.Note that __CLASS__ and __METHOD__ both reference the class the code is written in, not whatever the object class is. E.g. if you have an object of class B inheriting from class A, any usage of __CLASS__ in class A is going to give "A".If PHP is run inside a web server request there is an important difference between the __DIR__ constant and $_SERVER['DOCUMENT_ROOT'].
Where __DIR__ of a PHP script contained within a sub-folder will include the complete server path $_SERVER['DOCUMENT_ROOT'] will contain a server path up to the _root_ of the application. This can be helpful when for instance an auto-loader is defined in an include file sitting inside a sub-folder and where the classes are located in another folder at the root of the application.