Классы и ООП в PHP 8: свойства, конструктор, наследование
Класс в PHP описывает данные и операции над ними, а объект хранит состояние конкретного экземпляра. Разберём, как объявлять свойства, проверять данные в конструкторе, расширять классы через наследование и выбирать между self, static и parent.
Классы в PHP: объявление class и создание объекта
Ключевое слово class объявляет класс. Внутри можно определить свойства, методы и константы. Оператор new создаёт объект, -> обращается к его свойству или методу, а $this внутри метода указывает на текущий объект.
<?php
declare(strict_types=1);
final class Counter
{
private int $value = 0;
public function increment(): void
{
$this->value++;
}
public function value(): int
{
return $this->value;
}
}
$first = new Counter();
$second = new Counter();
$first->increment();
echo $first->value(), ' ', $second->value(); // 1 0У каждого экземпляра своё значение $value. При присваивании $alias = $first обе переменные указывают на один объект. Для отдельной копии используют clone. По умолчанию он копирует объект поверхностно, поэтому вложенные объекты остаются общими. Модификатор final у класса запрещает наследоваться от него.
Директива declare(strict_types=1) включает строгий режим проверки скалярных типов для вызовов из текущего файла. Если файл, где объявлен класс, использует строгий режим, а вызывающий файл работает в обычном режиме, решение о приведении скалярных аргументов принимает вызывающий файл. Для возвращаемых значений действует режим файла, где объявлена функция или метод.
Свойства: типы, видимость и readonly
Свойство public доступно извне, protected доступно в самом классе и его наследниках, private доступно в области видимости объявившего его класса. Если изменение поля требует проверки или влияет на другие поля, удобно оставить его закрытым и менять через метод.
<?php
declare(strict_types=1);
final class Task
{
public readonly int $id;
private ?DateTimeImmutable $closedAt = null;
public function __construct(int $id)
{
$this->id = $id;
}
public function close(DateTimeImmutable $at): void
{
$this->closedAt ??= $at; // Сохраняем время первого закрытия.
}
public function isClosed(): bool
{
return $this->closedAt !== null;
}
}
$task = new Task(42);
$task->close(new DateTimeImmutable());
var_dump($task->isClosed()); // bool(true)Объявление private ?DateTimeImmutable $closedAt; оставляет свойство неинициализированным. Знак ? разрешает присвоить null, а начальное значение нужно задать отдельно. Чтение неинициализированного типизированного свойства вызывает Error. Задайте значение при объявлении или присвойте его в конструкторе.
После обычной инициализации свойство readonly защищено от повторного присваивания. Если в нём хранится изменяемый объект, его методы всё равно могут менять его состояние. Для даты, которую требуется сохранить в исходном виде, подходит DateTimeImmutable. Начиная с PHP 8.3, при клонировании __clone() может повторно инициализировать свойство readonly на копии.
Конструктор PHP: __construct() и объявление свойств в параметрах
PHP вызывает метод __construct() при обычном создании экземпляра через new. Конструктор принимает обязательные зависимости и проверяет данные, необходимые для корректного состояния объекта. Тип возвращаемого значения у конструктора не указывают, включая void. Если проверка заканчивается исключением, выражение new не возвращает объект вызывающему коду.
<?php
declare(strict_types=1);
final class Money
{
public function __construct(
public readonly int $minorUnits,
public readonly string $currency,
) {
if ($minorUnits < 0) {
throw new InvalidArgumentException('Сумма должна быть неотрицательной');
}
if (preg_match('/\A[A-Z]{3}\z/', $currency) !== 1) {
throw new InvalidArgumentException('Код валюты должен содержать три заглавные латинские буквы');
}
}
}
$price = new Money(12_500, 'RUB'); // 125 рублей в копейках.
echo $price->minorUnits;Параметр с модификатором видимости одновременно объявляет свойство. PHP присваивает ему аргумент перед выполнением тела __construct(). Такой синтаксис называется constructor property promotion. Аргумент 12500 проходит проверку типа int, а проверка знака задаёт правило предметной области. Регулярное выражение проверяет формат кода валюты. Если допустим только заданный список валют, проверяйте принадлежность этому списку.
Типичная ошибка с продвижением свойств возникает при нормализации входных данных. Если $currency объявлено как продвинутое readonly-свойство, попытка присвоить ему strtoupper($currency) в теле конструктора вызовет Error: свойство уже инициализировано. Для нормализации объявите свойство отдельно, примите обычный параметр и присвойте результат один раз.
Наследование в PHP: extends, parent и переопределение методов
Класс может наследоваться от одного родителя через extends. Наследник получает доступ к публичным и защищённым членам родителя. Закрытое состояние родителя остаётся доступным его собственным методам. Если наследник объявляет свой конструктор, вызов родительского конструктора нужно прописать явно. Если своего конструктора нет, наследуется доступный конструктор родителя.
<?php
declare(strict_types=1);
class Notification
{
public function __construct(private readonly string $message)
{
if ($message === '') {
throw new InvalidArgumentException('Сообщение не должно быть пустым');
}
}
public function text(): string
{
return $this->message;
}
}
final class Alert extends Notification
{
public function __construct(string $message, private readonly string $level)
{
parent::__construct($message); // Проверка и инициализация сообщения.
}
#[\Override]
public function text(): string
{
return '[' . $this->level . '] ' . parent::text();
}
}
echo (new Alert('Диск почти заполнен', 'WARN'))->text();Для переопределяемых методов сохраняйте совместимую сигнатуру. Наследник может расширить тип параметра и сузить тип возвращаемого значения. Например, параметр Dog можно расширить до Animal, а возвращаемый Animal сузить до Dog, если Dog наследует Animal. Видимость метода можно расширить, например с protected до public. Метод final переопределять запрещено.
Атрибут #[\Override] для методов доступен с PHP 8.3. Он выявляет опечатку или устаревшее имя при объявлении класса: помеченный метод должен соответствовать методу родительского класса или интерфейса. Для конструктора этот атрибут применять нельзя.
self в PHP: отличие от static, parent и $this
self:: обращается к классу, где написан код, static:: использует позднее статическое связывание и учитывает класс вызова. Через parent:: можно вызвать реализацию родителя. Через $this-> работают с текущим экземпляром. В статическом методе $this недоступен.
<?php
declare(strict_types=1);
class BaseReport
{
protected const string FORMAT = 'text';
public static function formats(): array
{
return [self::FORMAT, static::FORMAT];
}
public static function create(): static
{
return new static(); // Создаём экземпляр класса вызова.
}
}
final class CsvReport extends BaseReport
{
protected const string FORMAT = 'csv';
}
var_export(CsvReport::formats()); // ['text', 'csv']
echo PHP_EOL, get_class(CsvReport::create()); // CsvReportВозвращаемый тип self привязан к классу, где объявлен метод, и допускает объект этого класса или его наследника. Тип static обещает результат, совместимый с классом вызова. Для фабрики с new static() убедитесь, что конструкторы наследников можно вызывать с передаваемыми аргументами. Если наследник добавит обязательный параметр, этот пример завершится ArgumentCountError при вызове фабрики через него.
ООП в PHP: интерфейсы и композиция
Интерфейс задаёт контракт, который могут реализовать разные классы. Композиция позволяет передать объект с нужным поведением в конструктор. Например, форматирование отчёта можно выбрать при создании экспортёра, сохраняя один и тот же класс экспортёра.
<?php
declare(strict_types=1);
interface Formatter
{
public function format(array $row): string;
}
final class JsonFormatter implements Formatter
{
public function format(array $row): string
{
// Ошибку сериализации получит вызывающий код.
return json_encode($row, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
}
}
final class Exporter
{
public function __construct(private readonly Formatter $formatter) {}
public function export(array $row): string
{
return $this->formatter->format($row);
}
}
echo (new Exporter(new JsonFormatter()))->export(['id' => 42]); // {"id":42}Абстрактный класс полезен, когда у нескольких реализаций есть общие состояние и код. Класс с implements может реализовать несколько интерфейсов. Трейт через use добавляет повторно используемые методы или свойства. Если код должен принимать любую подходящую реализацию, укажите тип интерфейса в сигнатуре.
Что меняется в PHP 8.3–8.5
| Версия | Что важно для классов |
|---|---|
| 8.3 | Типизированные константы классов, например const string FORMAT = 'text';, атрибут #[\Override] для методов и повторная инициализация readonly-свойств в __clone(). |
| 8.4 | Хуки get и set у свойств, асимметричная видимость записи для типизированных свойств экземпляра. Например, public private(set) string $status; разрешает читать значение извне, а записывать его можно внутри объявившего класса. У readonly-свойств по умолчанию видимость записи стала protected(set), что позволяет наследнику их инициализировать. |
| 8.5 | Атрибут #[\Override] применим к свойствам. Видимость записи можно отдельно задать и для статического свойства. Выражение clone $object with [...] позволяет установить указанные свойства на копии, включая readonly, если запись доступна в текущей области видимости. |
Если минимальная версия проекта 8.3, держите общий код на её синтаксисе. Файл с хуками свойств PHP 8.3 не сможет разобрать даже внутри ветки, защищённой проверкой PHP_VERSION_ID. При поддержке нескольких версий запускайте линтер и тесты на минимальной и максимальной целевых версиях.
Чек-лист для класса перед ревью
- Объявите свойства и их типы. Не создавайте поля случайным присваиванием вроде
$task->stauts = 'closed'. Создание динамических свойств у обычных классов без разрешения устарело с PHP 8.2, а объявленные поля помогают ловить опечатки статическим анализом. - Проверьте, что конструктор инициализирует все свойства, которые методы читают сразу после создания объекта. Для допустимого пустого состояния явно задайте
= null. - Проверьте данные до завершения конструктора. Используйте
readonlyдля значений, которые должны сохраняться после инициализации. - При наследовании проверьте вызов
parent::__construct(), сигнатуры методов и поведение наследника там, где код ожидает родительский тип. - В статических фабриках проверьте, какой класс должен создаваться при вызове через наследника, и согласуйте
new self()илиnew static()с возвращаемым типом.
Частые вопросы
Обязательно ли писать конструктор в PHP-классе?
Нет. Если свойствам хватает начальных значений и при создании объекта не нужны аргументы или проверки, собственный конструктор можно опустить. При наследовании учитывайте сигнатуру родительского конструктора, если он есть и доступен.
Чем self отличается от $this в PHP?
self привязан к классу, где объявлен метод. Его используют, например, в self::CONSTANT, new self() и типе результата self. $this указывает на текущий объект и доступен в нестатических методах.
Почему PHP выдаёт ошибку Typed property must not be accessed before initialization?
Код читает типизированное свойство до первого присваивания. Инициализируйте его при объявлении или в конструкторе. Если свойство допускает null и это подходящее начальное состояние, задайте = null явно.