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 obtenu dynamiquement. La fonction get_defined_constants() permet de 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 tout cas, ils peuvent avoir des valeurs différentes).

Si une constante indéfinie est utilisée, une Error est levée. Avant 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. Avant 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) qualifiées, qui lèvent toujours une Error si elles ne sont pas définies.

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; // Lève une Error : Undefined constant "Constant"
                 // Avant PHP 8.0.0, affiche "Constant" 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.'; Au revoir le monde !';
echo ANOTHER_CONST;

const ANIMALS = array('chien', 'chat', 'oiseaux');
echo ANIMALS[1]; // affiche "chat"

// Tableaux constants
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.

Voir aussi

Les Constantes de Classe