Константы в PHP: define, const и константы классов
Константа в PHP хранит значение, которое после объявления нельзя изменить. Для обычных констант используют const или define(), а для значений, связанных с классом, — константы класса. Выбор зависит от того, где нужно обращаться к значению и когда оно становится известно.
Как работают константы в PHP
У имени константы нет префикса $. Принято писать имена прописными буквами и разделять слова подчёркиваниями, например MAX_RETRIES. Регистр важен: MAX_RETRIES и max_retries — разные имена.
<?php
const MAX_RETRIES = 3;
echo MAX_RETRIES; // 3Обычной константе можно присвоить число, строку, логическое значение, null или массив. Например, объявление const RETRY_DELAYS = [1, 5, 15]; позволяет читать RETRY_DELAYS[0]. Изменять элементы этого массива через имя константы нельзя.
| Синтаксис | Когда выбирать | Как читать |
|---|---|---|
const MAX_RETRIES = 3; | Имя и значение известны при написании кода | MAX_RETRIES |
define('MAX_RETRIES', $limit); | Имя или значение определяется при выполнении программы | MAX_RETRIES или constant($name) |
public const int MAX_RETRIES = 3; | Значение связано с классом и может быть частью его публичного API | RetryPolicy::MAX_RETRIES |
PHP const: объявление на уровне файла
Объявление const на уровне файла может находиться в пространстве имён. Его нельзя поместить внутрь функции, условия или цикла. Справа от = допустимо константное выражение, например арифметика, массив или ссылка на другую константу. Для значения из переменной или результата обычного вызова функции используйте define().
<?php
namespace App\Billing;
const MINUTES_PER_HOUR = 60;
const DEFAULT_TIMEOUT = 2 * MINUTES_PER_HOUR;
const RETRY_DELAYS = [1, 5, 15];
echo DEFAULT_TIMEOUT; // 120Из другого пространства имён константу можно прочитать по полному имени \App\Billing\DEFAULT_TIMEOUT или импортировать через use const App\Billing\DEFAULT_TIMEOUT;. При обращении по простому имени PHP сначала ищет константу в текущем пространстве имён и, если её там нет, проверяет глобальное. Для явно квалифицированного имени такого перехода нет.
PHP define: объявление при выполнении
define() принимает имя константы строкой и готовое значение. Вызов можно поместить в условие или функцию. Объявленная таким способом константа доступна после выполнения вызова независимо от того, внутри какой функции она была объявлена.
<?php
declare(strict_types=1);
$raw = getenv('APP_MAX_RETRIES');
$limit = filter_var($raw, FILTER_VALIDATE_INT, [
'options' => ['min_range' => 0, 'max_range' => 10],
]);
// Ноль допустим. Подставляем значение по умолчанию при ошибке проверки.
define('APP_MAX_RETRIES', $limit === false ? 3 : $limit);
echo APP_MAX_RETRIES;В PHP 8.x константы, объявленные через define(), чувствительны к регистру. Для нового кода передавайте два аргумента. Вызов define('FLAG', true) можно использовать при загрузке приложения, если значение должно стать общим для дальнейшего выполнения программы.
Как работает define в пространстве имён
define() использует имя ровно в том виде, в каком оно передано строкой. Даже внутри файла с namespace App\Config; вызов define('TIMEOUT', 30) создаст глобальную константу. Чтобы объявить константу в текущем пространстве имён, добавьте его к имени явно.
<?php
namespace App\Config;
\define(__NAMESPACE__ . '\\TIMEOUT', 30);
echo TIMEOUT; // 30
echo \App\Config\TIMEOUT; // 30Константы классов: типы, видимость и наследование
Константу класса читают через ::, поэтому создавать объект не требуется. Модификатор public открывает доступ снаружи, protected ограничивает доступ классом и его наследниками, private — самим объявляющим классом. При отсутствии модификатора константа публичная. Значение задаётся константным выражением.
<?php
declare(strict_types=1);
class RetryPolicy
{
public const int MAX_RETRIES = 3;
private const array DELAYS = [1, 5, 15];
public static function firstDelay(): int
{
return self::DELAYS[0]; // Первый интервал в секундах
}
}
echo RetryPolicy::MAX_RETRIES; // 3
echo RetryPolicy::firstDelay(); // 1Тип константы и strict_types
С PHP 8.3 можно указывать тип константы класса, интерфейса, трейта или перечисления. Например, public const int LIMIT = '3'; вызовет ошибку, поскольку строка не соответствует объявленному типу. Проверка типа самой константы действует и без declare(strict_types=1). Эта директива уместна там, где нужны строгие правила для объявленных скалярных типов функций. Обычные константы уровня файла типизировать синтаксисом const int LIMIT = 3; нельзя, а define() сохраняет тип переданного значения.
self::, static:: и final
self:: ссылается на класс, в котором написан метод. static:: учитывает класс, через который метод вызвали. Это важно, когда наследник переопределяет константу. Для типизированных констант тип при переопределении можно сохранить или сузить, например с int|string до int. final запрещает переопределение.
<?php
declare(strict_types=1);
class ExportFormat
{
public const string SEPARATOR = ',';
final public const string ENCODING = 'UTF-8';
public static function separator(): string
{
return static::SEPARATOR;
}
}
class TsvFormat extends ExportFormat
{
public const string SEPARATOR = "\t";
}
var_dump(TsvFormat::separator() === "\t"); // true
// С self::SEPARATOR метод вернул бы запятую.Как проверить наличие константы и прочитать её по имени
defined() проверяет наличие константы, а constant() возвращает её значение по строковому имени. Для константы в пространстве имён передайте полное имя, для константы класса — строку вида RetryPolicy::MAX_RETRIES. Проверять наличие полезно, когда имя определено во время выполнения или константа может отсутствовать.
<?php
const DEFAULT_REGION = null;
$name = 'DEFAULT_REGION';
if (defined($name)) {
var_dump(constant($name)); // NULL. Константа существует.
}С PHP 8.3 константу класса по динамическому имени можно прочитать через ClassName::{$name}. Этот синтаксис соблюдает видимость константы. Если доступно несколько публичных значений, которые выбираются по входному параметру, задайте список допустимых имён.
<?php
final class HttpStatus
{
public const int OK = 200;
public const int NOT_FOUND = 404;
}
$name = 'NOT_FOUND';
if (in_array($name, ['OK', 'NOT_FOUND'], true)) {
echo HttpStatus::{$name}; // 404
}Типичные ошибки с константами
- Опечатка в имени или регистре. Чтение
max_retriesпри объявленнойMAX_RETRIESприведёт кError, если константы с таким именем нет. Если нужна строка, заключите её в кавычки. - Повторный вызов define(). При повторном объявлении того же имени
define()выдаёт предупреждение и возвращаетfalse. Первое значение сохраняется. Загружайте файл с объявлением один раз черезrequire_once. Если по контракту допускается заранее заданная константа, используйтеif (!defined('APP_MODE')) { define('APP_MODE', 'production'); }. - Константа используется до её объявления. Это встречается, когда файл с
define()подключается слишком поздно или вызов пропускается по условию. Проверьте порядок загрузки и ветки выполнения. - Вызов функции в объявлении const. Выражение
const BUILD_TIME = time();недопустимо. Если нужна метка времени запуска, её можно сохранить вызовомdefine('BUILD_TIME', time());. - Строка из конфигурации принимается за число.
define('PORT', '8080')создаст строковую константу. Если дальше нуженint, проверьте входное значение и передайте результат преобразования. - Перепутаны константа класса и статическое свойство.
Config::TIMEOUTобращается к константе,Config::$timeout— к статическому свойству. Выберите свойство, если значение должно изменяться во время работы.
Что учитывать в PHP 8.3–8.5
- PHP 8.3. Появились типизированные константы классов и синтаксис
ClassName::{$name}. Обе возможности доступны и в PHP 8.4 и 8.5. - PHP 8.4 и 8.5. Все рабочие примеры статьи используют общий синтаксис PHP 8.3–8.5. Если библиотека должна работать на всех трёх версиях, проверяйте её на PHP 8.3 как на нижней границе совместимости.
- Весь PHP 8.x. Обращение к неопределённой константе вызывает
Error. Для поддержки PHP 8.0–8.2 уберите типы из объявлений констант классов и используйтеconstant(ClassName::class . '::' . $name)для динамического чтения публичной константы. Модификаторfinalдля констант классов доступен с PHP 8.1.
Чек-лист: какую константу выбрать
- Используйте
constна уровне файла, если значение фиксировано и относится к модулю. Поместите объявление в пространство имён модуля. - Выберите
define(), если имя или значение нужно вычислить при запуске. Проверьте входные данные до объявления. - Поместите значение в класс, если оно относится к его поведению или API. Укажите видимость, а на PHP 8.3 и выше — тип, если он входит в контракт.
- Добавьте
final, если переопределение в наследнике нарушит контракт. Осознанно выбирайте междуself::иstatic::при чтении из метода. - Для необязательной константы с динамическим именем сначала вызовите
defined(), затемconstant().
Частые вопросы
В чём разница между define и const в PHP?
const объявляет константу с фиксированным именем и константным выражением. define() выполняется как обычная функция, поэтому принимает имя и значение, вычисленные во время работы программы. Константы классов объявляют через const.
Можно ли изменить значение константы PHP?
После объявления значение константы изменить нельзя. Наследник может объявить собственное значение константы класса, если правила видимости и типов это допускают и константа не помечена final. Значение в родительском классе при этом сохраняется.
Как проверить, объявлена ли константа в PHP?
Передайте имя в defined(). Для обычной константы подойдёт defined('APP_MODE'), для публичной константы класса — defined('Config::TIMEOUT'). Проверка вернёт true и для объявленной константы со значением null.