define
(PHP 4, PHP 5, PHP 7, PHP 8)
define — Визначає іменовану константу
Опис
define(string $constant_name, mixed $value, bool $case_insensitive = false): bool
Визначає іменовану константу під час виконання.
Список параметрів
constant_name
Ім'я константи.
Зауваження :
Можна визначити константи за допомогою функції define() зарезервованими або навіть некоректними іменами, значення яких можуть (тільки) отримані через функцію constant(). Однак робити це не рекомендується.
value
Значення константи. У PHP 5 value має бути скалярним значенням (int, float, string, bool або null). У PHP 7 також можна використовувати тип array.
Увага
Хоча можливо визначити константи з типом resource, це не рекомендується робити, оскільки може призвести до непередбачуваної поведінки.
case_insensitive
Если параметр установлен как**true**, то константа буде визначено без урахування регістру. За умовчанням константа чутлива до регістру, тобто CONSTANTиConstant представляють різні значення.
Увага
Починаючи з PHP 7.3.0, визначення нечутливих до регістру констант оголошено застарілим. Починаючи з PHP 8.0.0, допустимим значенням є лише false, передача**true** Викликає попередження.
Зауваження :
Нечутливі до регістру константи зберігаються у нижньому регістрі.
Значення, що повертаються
Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | Передача**true**вcase_insensitive тепер видає помилку рівня E_WARNINGПередачаfalse все ще дозволено. |
| 7.3.0 | Параметрcase_insensitive оголошено застарілим та буде видалено у версії 8.0.0. |
| 7.0.0 | Допустимі значення типу array. |
Приклади
Приклад #1 Визначення констант
Приклад #2 Визначення констант зарезервованими іменами
Цей приклад демонструє можливість визначення константи з тим самим ім'ям, що й магічна константа. Оскільки це, очевидно, поведінка, що збиває з пантелику, не рекомендується робити це на практиці.
Результат виконання наведеного прикладу:
bool(false)
bool(true)
string(4) "test"
int(5)
Дивіться також
- defined() - Перевіряє існування вказаної іменованої константи
- constant() - Повертає значення константи
- Смотрите раздел Константи