constant

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

constant — Retorna el valor de una constante

Descripción

function constant(string $name): mixed

Retorna el valor de la constante name.

constant() es útil cuando se debe leer el valor de una constante, pero su nombre solo se conoce durante la ejecución del script. Por ejemplo, este nombre puede ser el resultado de una función.

Esta función también funciona con las constantes de clase y tipos enum.

Parámetros

name

El nombre de la constante.

Valores devueltos

Retorna el valor de la constante.

Errores/Excepciones

Si la constante no está definida, se lanza una excepción Error. Anteriormente a PHP 8.0.0, se emitía un error de nivel E_WARNING en este caso.

Historial de cambios

Versión Descripción
8.0.0 Si la constante no está definida, constant() ahora lanza una excepción Error; anteriormente se emitía un E_WARNING y se retornaba null.

Ejemplos

Ejemplo #1 Uso de la función constant() con constantes

<?php

define("MAXSIZE", 100);

echo MAXSIZE;
echo constant("MAXSIZE"); // idéntico a la línea anterior

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

?>

Ejemplo #2 Uso de la función constant() con tipos enum (a 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)

?>

Ver también