(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
constant — Retourne la valeur d'une constante
Description
constant(string
$name
): mixed
Retourne la valeur de la constante name
.
constant() est pratique lorsque vous devez lire la
valeur d'une constante, mais que vous ne connaissez son nom que durant
l'exécution du script. Par exemple, ce nom peut être le résultat
d'une fonction.
Cette fonction fonctionne également avec les
constantes de classe et types enum
Liste de paramètres
-
name
-
Le nom de la constante.
Valeurs de retour
Retourne la valeur de la constante.
Erreurs / Exceptions
Si la constante n'est pas définie, une exception Error est levée.
Antérieur à PHP 8.0.0, une erreur de niveau E_WARNING
était émise dans ce cas.
Historique
Exemples
Exemple #1 Utilisation de la fonction constant() avec des constantes
<?php
define("MAXSIZE", 100);
echo MAXSIZE;
echo constant("MAXSIZE"); // identique à la ligne précédente
interface bar {
const test = 'foobar!';
}
class foo {
const test = 'foobar!';
}
$const = 'test';
var_dump(constant('bar::'. $const)); // string(7) "foobar!"
var_dump(constant('foo::'. $const)); // string(7) "foobar!"
?>
Exemple #2 Utilisation de la fonction constant() avec des types enum (à partir de PHP 8.1.0)
<?php
enum Suit
{
case Hearts;
case Diamonds;
case Clubs;
case Spades;
}
$case = 'Hearts';
var_dump(constant('Suit::'. $case)); // enum(Suit::Hearts)
?>
Voir aussi
- define() - Définit une constante
- defined() - Vérifie l'existence d'une constante
- get_defined_constants() - Retourne la liste des constantes et leurs valeurs
- La section sur les constantes