CKTIS / PHP
define()
A função define cria em execução uma constante sensível a maiúsculas cujo nome textual pode incluir um espaço de nomes.
Versão: PHP 8.4; repository runtime, production runtime not attested
Sintaxe
define(string $constant_name, mixed $value, bool $case_insensitive = false): boolA função define cria em execução uma constante sensível a maiúsculas cujo nome textual pode incluir um espaço de nomes. O sucesso devolve true. Redefinir o nome emite E_WARNING, devolve false e mantém o valor original. Em PHP 8.4 a opção de ignorar maiúsculas não cria uma constante insensível à capitalização. Para um nome novo, case_insensitive=true emite E_WARNING mas devolve true e cria uma constante sensível a maiúsculas e minúsculas.
Assinatura
define(string $constant_name, mixed $value, bool $case_insensitive = false): bool
Saída do exemplo
[true,3,false]
warning [false,3]
warning [true,true,false]
Exemplos
<?php
$key = "Example\\LEVEL";
echo json_encode([define($key, 3), constant($key), defined("Example\\level")]), PHP_EOL;
set_error_handler(function (int $severity): bool {
echo $severity === E_WARNING ? "warning " : "other ";
return true;
});
try {
$ok = define($key, 9);
echo json_encode([$ok, constant($key)]), PHP_EOL;
$fresh = define("FreshKey", 7, true);
echo json_encode([$fresh, defined("FreshKey"), defined("freshkey")]);
} finally { restore_error_handler(); }
Resultado
[true,3,false] warning [false,3] warning [true,true,false]