Verifica se existe uma constante com o nome informado

# defined

(PHP 4, PHP 5, PHP 7, PHP 8)

defined — Verifica se existe uma constante com o nome informado

### Descrição

function defined(string `$constant_name`): bool

Verifica se uma constante com o nome informado em `constant_name` está definida.

A função também funciona com constantes de classe e casos de enumeração.

> Nota:

> Se o objetivo for verificar se uma variável existe, use a função isset() já que a função defined() somente se aplica a constantes. Se o objetivo for verificar se uma função existe, use a função function_exists().

### Parâmetros

`constant_name`

  O nome da constante.

### Valor Retornado

Retorna `true` se a constante nomeada informada por `constant_name` já está definida, `false` caso contrário.

### Exemplos

Exemplo #1 Verificando constantes

    <?php

    /* Observe o uso de aspas, isto é importante. Este exemplo está verificando
     * se a string 'TEST' é o nome de uma constante chamada TEST */
    if (defined('TEST')) {
        echo TEST;
    }

    interface bar {
        const test = 'foobar!';
    }

    class foo {
        const test = 'foobar!';
    }

    var_dump(defined('bar::test')); // bool(true)
    var_dump(defined('foo::test')); // bool(true)

    ?>

Exemplo #2 Verificando Casos de Enumeração (a partir do PHP 8.1.0)

    <?php

    enum Suit
    {
        case Hearts;
        case Diamonds;
        case Clubs;
        case Spades;
    }

    var_dump(defined('Suit::Hearts')); // bool(true)

    ?>

### Veja Também

- define() - Define uma constante com nome
- constant() - Retorna o valor de uma constante
- get_defined_constants() - Retorna um array associativo com os nomes de todas as constantes e seus valores
- function_exists() - Retorna true se a função informada estiver definida
- A seção sobre Constantes

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open