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 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

    VersionDescription
    8.0.0 Si la constante n'est pas définit, 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

    To Top