PHPTime

Классы и ООП в PHP 8: свойства, конструктор, наследование

Класс в PHP описывает данные и операции над ними, а объект хранит состояние конкретного экземпляра. Разберём, как объявлять свойства, проверять данные в конструкторе, расширять классы через наследование и выбирать между self, static и parent.

Классы в PHP: объявление class и создание объекта

Ключевое слово class объявляет класс. Внутри можно определить свойства, методы и константы. Оператор new создаёт объект, -> обращается к его свойству или методу, а $this внутри метода указывает на текущий объект.

PHP
<?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
<?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
<?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
<?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
<?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
<?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 явно.

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

Ещё в разделе «Справочник PHP»

Константы в PHP: define, const и константы классов

Как объявлять константы в PHP через define и const, работать с константами классов, проверять их наличие и учитывать отличия PHP 8.3, 8.4 и 8.5.

7 мин

Массив в строку и строку в массив: implode, explode, json, serialize

Как преобразовать массив в строку и обратно в PHP 8.3–8.5: implode, explode, preg_split, JSON и serialize. Как вывести массив через print_r и var_dump.

9 мин

Массивы в PHP: создание, перебор и основные функции

Как создавать массивы в PHP, работать с ключами и индексами, перебирать элементы, фильтровать и объединять данные. Примеры и отличия PHP 8.3–8.5.

9 мин

Настройка php.ini: memory_limit, upload_max_filesize, таймауты

Как настроить php.ini в PHP 8.3–8.5: выбрать memory_limit, согласовать лимиты загрузки и таймауты PHP-FPM и Nginx, проверить настройки и разобрать ошибки.

8 мин