array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.constant.php', 1 => 'constant', 2 => 'Возвращает значение константы', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Разные функции', ), 'prev' => array ( 0 => 'function.connection-status.php', 1 => 'connection_status', ), 'next' => array ( 0 => 'function.define.php', 1 => 'define', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/misc/functions/constant.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

constant

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

constant — Возвращает значение константы

Описание

constant(string $name): mixed

Функция возвращает значение константы, на имя которой указывает параметр name.

Функция constant() полезна, когда требуется получить значение константы, но имя константы неизвестно — когда название константы хранится в переменной или возвращается функцией.

Функция также работает с константами классов и вариантами перечисления.

Список параметров

name

Имя константы.

Возвращаемые значения

Функция возвращает значение константы.

Ошибки

Функции выбросит исключение Error, если константу с именем, которое содержит параметр, не определили. До PHP 8.0.0 выдавалась ошибка уровня E_WARNING.

Список изменений

Версия Описание
8.0.0 Теперь функция constant() выбрасывает исключение Error, если константу не определили; раньше выдавалась ошибка уровня E_WARNING и возвращалось значение null.

Примеры

Пример #1 Пример использования функции constant() с константами

<?php

define("MAXSIZE", 100);

echo MAXSIZE;
echo constant("MAXSIZE"); // Результат аналогичен предыдущему выводу


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

?>

Пример #2 Пример использования функции constant() с вариантами перечисления (начиная с 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)

?>

Смотрите также