PHP is developed and maintained by a global community of contributors.
The PHP Foundation helps fund this work. If PHP is part of your business or projects, consider sponsoring the Foundation.
(PHP 4, PHP 5, PHP 7, PHP 8)
define — Définit une constante
Définit une constante à l'exécution.
constant_nameLe nom de la constante.
Note:
Il est possible de définir avec define() des constantes avec des noms réservés ou même invalides, où leurs valeurs peuvent (seulement) être récupérées avec la fonction constant(). Cependant, faire ceci n'est pas recommandé.
define() prend le nom comme une simple string et ne le résout pas par rapport au namespace courant. À l'intérieur de
namespace My\Namespace;,define('MYCONST', 1)définit doncMYCONSTdans le namespace global, silencieusement et sans erreur. Pour placer la constante dans un namespace, le namespace doit faire partie du nom, écrit sans séparateur de namespace initial, comme dansdefine('My\Namespace\MYCONST', 1)oudefine(__NAMESPACE__ . '\MYCONST', 1). Contrairement à defined() et constant(), define() ne supprime pas un séparateur initial :define('\My\Namespace\MYCONST', 1)retournetruemais crée une constante qui ne pourra jamais être récupérée. Le nom étant une simple chaîne de caractères, les alias introduits par les instructionsusene lui sont pas appliqués. Dans une chaîne entre guillemets doubles, les séparateurs de namespace doivent être échappés, comme dans"My\\Namespace\\MYCONST".
valueLa valeur de la constante.
Bien qu'il soit techniquement possible de définir des constantes de type resource, ceci est déconseillé et peut causer des comportements inattendus.
case_insensitive
S'il vaut true, la constante sera définie de manière insensible à la casse.
Le comportement par défaut est sensible à la casse, c.-à-d. que
CONSTANT et Constant
représentent des valeurs différentes.
Définir des constantes insensibles à la casse est obsolète à partir de PHP 7.3.0.
À partir de PHP 8.0.0, seul false est une valeur acceptable,
passer true produira un avertissement.
Note:
Les constantes insensibles à la casse sont stockées en minuscule.
| Version | Description |
|---|---|
| 8.1.0 |
value peut désormais être un objet.
|
| 8.0.0 |
Passer true à case_insensitive émet désormais une E_WARNING.
Passer false est toujours autorisé.
|
| 7.3.0 |
case_insensitive est obsolète et sera supprimée dans la version 8.0.0.
|
Exemple #1 Définition d'une constante
<?php
define("CONSTANT", "Bonjour le monde.");
echo CONSTANT; // affiche "Bonjour le monde."
echo Constant; // affiche "Constant" et émet une alerte
define("GREETING", "Salut toi.", true);
echo GREETING; // affiche "Salut toi."
echo Greeting; // affiche "Salut toi."
// Fonctionne à partir de PHP 7
define('ANIMALS', array(
'chien',
'chat',
'oiseaux'
));
echo ANIMALS[1]; // affiche "chat"
?>
Exemple #2 Constantes avec des Noms Réservés
Cet exemple illustre la possibilité de définir une constante avec le même nom qu'une constante magique. Puisque le comportement qui en résulte porte à confusion, cette pratique n'est pas recommandée.
<?php
var_dump(defined('__LINE__'));
var_dump(define('__LINE__', 'test'));
var_dump(constant('__LINE__'));
var_dump(__LINE__);
?>L'exemple ci-dessus va afficher :
bool(false) bool(true) string(4) "test" int(5)
