array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.constant.php', 1 => 'constant', 2 => 'Retourne la valeur d\'une constante', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Fonctions diverses', ), 'prev' => array ( 0 => 'function.connection-status.php', 1 => 'connection_status', ), 'next' => array ( 0 => 'function.define.php', 1 => 'define', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/misc/functions/constant.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

constant

(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 lorsqu'il faut lire la valeur d'une constante, mais qu'on ne connaît 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

Version Description
8.0.0 Si la constante n'est pas définie, constant() lance désormais une exception Error ; auparavant une E_WARNING était émise, et null était retourné.

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