PHP 8.3.4 Released!

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.

add a note

User Contributed Notes 2 notes

up
32
souzanicolas87 at gmail dot com
2 years ago
the documentation doesn't go too far in explaining the crucial difference between the two ways of declaring constants in PHP.

Const is handled at compile time, define() at run time. For this reason, a constant cannot be conditionally defined using Const, for example.

Another difference we can notice occurs in the constant declarations in classes. Const infiltrates the class scope, while define() leaks into the global scope.

<?php

Class Myclass (){
const
NAME = "Nicolas";
}

?>

The NAME constant is within the scope of the MyClass class.
up
8
login at (two)view dot de
6 years ago
Just a quick note:
From PHP7 on you can even define a multidimensional Array as Constant:

define('QUARTLIST',array('1. Quarter'=>array('jan','feb','mar'),'2.Quarter'=>array('may','jun','jul'));

does work as expected.
To Top