Les constantes
Une constante est un identifiant (un nom) qui représente une valeur
simple. Comme son nom le suggère, cette valeur ne peut jamais être
modifiée durant l'exécution du script (sauf les
constantes magiques).
Les constantes sont sensibles à la casse. Par convention,
les constantes sont toujours en majuscule.
Antérieur à PHP 8.0.0, les constantes définies en utilisant la fonction
define peuvent être insensibles à la casse.
Les noms de constantes suivent les mêmes règles que n'importe
quel nom en PHP. Un nom de constante valide commence par une
lettre ou un souligné, suivi d'un nombre
quelconque de lettres, chiffres ou soulignés. Sous forme d'expression
régulière, cela peut s'exprimer comme ceci :
^[a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]*$
Il est possible de définir une constante avec un nom réservé ou même invalide via define,
ces valeurs ne peuvent alors être récupérées qu'avec la fonction
constant. Faire ceci n'est cependant pas recommandé.
&tip.userlandnaming;
Noms valides et invalides pour les constantes
]]>
Dans cette documentation, une lettre peut être un des caractères
suivants : de a à z, de A à Z et tous les caractères ASCII
de 128 à 255 (0x80-0xff).
Tout comme les &link.superglobals;, la portée d'une constante est globale.
Les constantes peuvent être accédées depuis partout dans un script sans tenir
compte de la portée.
Pour plus d'informations sur la portée, lisez la section du manuel sur la
portée des variables.
À partir de PHP 7.1.0, les constantes de classes peuvent définir une
visibilité de protégée ou privée, les rendant disponibles que dans la
portée hiérarchique de la classe où elles ont été définies.
Syntaxe
Les constantes peuvent être définies en utilisant le mot clé
const ou en utilisant la fonction
define.
Tandis que define permet de définir une
constante pour une expression arbitraire, le mot-clé
const a des restrictions comme indiqué
dans le paragraphe suivant.
Une fois qu'une constante est définie,
elle ne peut jamais être modifiée, ou détruite.
Lors de l'utilisation du mot-clé const,
seuls les expressions de type scalaires (bool,
int, float et string) et
des arrays constants contenant seulement des expressions
scalaires sont acceptées.
Il est possible de définir des constantes en tant que
resource, mais cet usage est déconseillé,
car il peut mener à des résultats inattendus.
La valeur d'une constante est accédée simplement en spécifiant son nom.
Contrairement aux variables, une constante n'est pas
préfixée d'un $.
Il est aussi possible d'utiliser la fonction constant
pour lire la valeur d'une constante si son nom est obtenue dynamiquement.
Utilisez la fonction get_defined_constants pour connaître
la liste de toutes les constantes définies.
Les constantes et les variables globales utilisent deux espaces de
noms différents. Ce qui implique que &true; et
$TRUE sont généralement différents (en tous cas, ils
peuvent avoir des valeurs différentes).
Si une constante indéfinie est utilisé une Error est
lancée.
Antérieur à PHP 8.0.0, les constantes indéfinies étaient interprétées comme un
mot nu de type &string;, c.à.d. (CONSTANT vs "CONSTANT").
Cette solution de repli est dépréciée à partir de PHP 7.2.0, et une erreur de
niveau E_WARNING était émise lorsque ce cas se produisait.
Antérieur à PHP 7.2.0, une erreur de niveau
E_NOTICE était émise à la place.
Voir également l'entrée du manuel qui explique pourquoi
$foo[bar] est faux
(sauf si bar est une constante).
Ceci ne s'applique pas pour les constantes (complètement) qualified,
qui lance toujours une Error.
Pour vérifier qu'une constante est définie, utiliser la fonction defined.
Il y a des différences entre les constantes et les variables :
Les constantes ne commencent pas par le signe ($).
Les constantes sont définies et accessibles à tout endroit du code,
globalement.
Les constantes ne peuvent pas être redéfinies ou indéfinies
une fois qu'elles ont été définies.
Les constantes peuvent seulement évaluer à des valeurs scalaires ou tableaux.
Définir une constante
]]>
Définir des constantes en utilisant le mot-clé const
]]>
Contrairement aux constantes définies en utilisant l'instruction
define, les constantes définies en utilisant
le mot-clé const doivent être déclarées
au plus haut niveau du contexte, car elles seront définies au moment
de la compilation. Cela signifie qu'elles ne peuvent être déclarées
à l'intérieur de fonctions, boucles, instructions
if ou blocs try/catch.
&reftitle.seealso;
Les Constantes de ClasseConstantes prédéfinie
PHP fournit un grand nombre de constantes prédéfinie. 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.
Constantes magiques
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'exécution.
Ces constantes spéciales sont insensibles à la casse.
Les constantes magiques de PHP&Name;&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.
__NAMESPACE__
Le nom de l'espace de noms courant.
ClassName::class
Le nom entièrement qualifié de la classe.