Использование const в классах PHP: синтаксис и нюансы

Начиная с PHP 7.1 константам можно назначать модификаторы видимости: public, protected, private. По умолчанию константы публичны.

class Config {
    public const PUBLIC_KEY = 'pub-xyz';
    protected const PROTECTED_KEY = 'protected-abc';
    private const SECRET = 's3cr3t';
    public function revealSecret(): string {
        return self::SECRET; // доступен внутри класса
    }
}
echo Config::PUBLIC_KEY; // pub-xyz
// echo Config::PROTECTED_KEY; // ошибка доступа
// echo Config::SECRET; // ошибка доступа
$cfg = new Config();
echo $cfg->revealSecret(); // s3cr3t

Константам можно присваивать скалярные значения (int, float, string, bool), а также массивы и выражения, которые могут быть вычислены на этапе компиляции. Выражения могут включать арифметические операции, константы других классов, но не вызовы функций (кроме define() и конструкций __CLASS__ и подобных не допускаются).

class Math {
    const PI = 3.14159;
    const DOUBLE_PI = self::PI * 2;
    const ALLOWED_TYPES = ['jpg', 'png', 'gif'];
}
echo Math::DOUBLE_PI; // 6.28318
print_r(Math::ALLOWED_TYPES); // Array ( [0] => jpg [1] => png [2] => gif )

class Foo {
    const BAR = time(); // Ошибка!
}

Да, константы можно переопределять в дочерних классах (переопределение не является обязательным). При обращении через имя дочернего класса будет использовано его значение, а при обращении через имя родительского класса - родительское.

class ParentClass {
    const VALUE = 'parent';
}
class ChildClass extends ParentClass {
    const VALUE = 'child';
}
echo ParentClass::VALUE; // parent
echo ChildClass::VALUE;  // child

Интерфейсы могут содержать константы, которые автоматически наследуются всеми классами, реализующими интерфейс. Это удобно для фиксации общих значений, связанных с поведением.

interface Statusable {
    const STATUS_ACTIVE = 1;
    const STATUS_INACTIVE = 0;
}
class User implements Statusable {
    public function getStatus(): int {
        return self::STATUS_ACTIVE; // доступна через self
    }
}
echo User::STATUS_ACTIVE; // 1

Обычное self:: всегда ссылается на класс, где написано определение. Для получения константы того класса, который вызвал метод (позднее статическое связывание), используется static::. Это особенно полезно при наследовании.

class ParentClass {
    const NAME = 'Parent';
    public function who(): string {
        return static::NAME;
    }
}
class ChildClass extends ParentClass {
    const NAME = 'Child';
}
$obj = new ChildClass();
echo $obj->who(); // Child

Трейты с PHP 8.2 могут содержать константы. Если трейт используется в нескольких классах, каждый класс получает собственную копию константы (возможны конфликты, которые разрешаются так же, как для методов).

trait Identifiable {
    const PREFIX = 'ID_';
    public function getId(): string {
        return self::PREFIX . spl_object_id($this);
    }
}
class Entity {
    use Identifiable;
}
echo Entity::PREFIX; // ID_

Константы класса применяются для хранения фиксированных настроек, статусов, кодов ошибок, названий событий - всего, что не должно меняться во время выполнения. Такой подход улучшает читаемость и уменьшает количество «магических чисел».

class HttpStatus {
    const OK = 200;
    const NOT_FOUND = 404;
    const INTERNAL_SERVER_ERROR = 500;
}
function handleResponse(int $code): void {
    if ($code === HttpStatus::OK) {
        echo 'Success';
    } elseif ($code === HttpStatus::NOT_FOUND) {
        echo 'Not found';
    }
}
handleResponse(404); // Not found