constant

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

constant — Retorna o valor de uma constante

Descrição

constant(string $name): mixed

Retorna o valor de uma constante indicada pelo parâmetro name.

A função constant() é útil se você precisa pegar o valor de uma constante, mas não sabe o seu nome. I.e. esta guardada em uma variável ou é retornada por uma função.

Esta função funciona também com constantes de classes e casos de enumeração.

Parâmetros

name

O nome da constante.

Valor Retornado

Retorna o valor da constante.

Erros/Exceções

Se a constante não estiver definida, uma exceção Error é lançada. Antes do PHP 8.0.0, um erro de nível E_WARNING era gerado nesse caso.

Registro de Alterações

Versão Descrição
8.0.0 If the constant is not defined, constant() now throws an Error exception; previously an E_WARNING was generated, and null was returned.

Exemplos

Example #1 Usando constant() com Constantes

<?php

define("MAXSIZE", 100);

echo MAXSIZE;
echo constant("MAXSIZE"); // mesma coisa que a linha 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!"

?>

Example #2 Usando constant()com Casos de Enumeração (a partir do 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)

?>

Veja Também