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.
Note:
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 chaîne de caractères, 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.
Note:
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.
Exemple #1 Définir une constante
<?php
define("CONSTANT", "Bonjour le monde.");
echo CONSTANT; // affiche "Bonjour le monde."
echo Constant; // Lance une Error : Undefined constant "Constant"
// Antérieur à PHP 8.0.0, affiche "Constante" et émet un avertissement.
?>
Exemple #2 Définir des constantes en utilisant le mot-clé const
<?php
// Simple valeur scalaire
const CONSTANT = 'Bonjour le monde !';
echo CONSTANT;
// Expression scalaire
const ANOTHER_CONST = CONSTANT.'; Aurevoir le monde !';
echo ANOTHER_CONST;
const ANIMALS = array('chien', 'chat', 'oiseaux');
echo ANIMALS[1]; // affiche "chat"
// Tableaux constant
define('ANIMALS', array(
'chien',
'chat',
'oiseaux'
));
echo ANIMALS[1]; // affiche "chat"
?>
Note:
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
.