PHP: Введение в ООП
2026-02-26 15:06 Diff
https://ru.hexlet.io/courses/php-introduction-to-oop/lessons/autoloading/theory_unit

Принято определять ровно один класс на файл. Более того, в этом файле больше не может быть никаких инструкций, не считая определения пространств имён. Чисто технически, язык не запрещает нарушать это правило, но лучше следовать стандартам кодирования PSR-12.

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

В случае с классами, пространство имён не содержит имени файла. Его роль выполняет само название класса. Причём файл должен называться в точности как класс и с учётом регистра.

Использовать этот класс в другом пространстве имён можно так:

либо так:

Полное описание требований к тому, как правильно стилистически именовать классы и как соотносить их с файловой структурой, приведено в стандарте PSR-4. Этот стандарт важно соблюдать по двум причинам. Первая связана с единым подходом к именованию и формированию структуры, что позволяет легко ориентироваться в проектах. Но есть и другая, не менее важная причина — автозагрузка классов.

Если определённое пространство имён в PHP содержит только функции, то для его загрузки используется специальная секция autoload/files в файле composer.json.

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

С классами ситуация другая. PHP содержит специальный механизм автозагрузки классов. Этот механизм работает так: если интерпретатор наталкивается на использование класса, то он проверяет, определили ли вы автозагрузчик классов, и, если определили, то вызывает его (пример). Composer определяет такой загрузчик автоматически. Его можно конфигурировать с помощью файла composer.json. Если структура классов в вашем приложении соответствует PSR-4, то конфигурация минимальна. Стандарт PSR-4 задаёт стиль именования, позволяющий однозначно определять полное имя класса (включая пространство имён) на основании пути до файла (относительно корня проекта) и наоборот.

Полное имя \Acme\Log\Writer\File_Writer:

  • Префикс: Acme\Log\Writer
  • Базовая директория: ./acme-log-writer/lib/
  • Результирующий путь: ./acme-log-writer/lib/File_Writer.php

Полное имя \Zend\Acl:

  • Префикс: Zend
  • Базовая директория: /usr/includes/Zend/
  • Результирующий путь: /usr/includes/Zend/Acl.php

Полное имя \Symfony\Core\Request:

  • Префикс: Symfony\Core
  • Базовая директория: ./vendor/Symfony/Core/
  • Результирующий путь: ./vendor/Symfony/Core/Request.php

В данном примере указано, что в директории src относительно расположения файла composer.json находится пространство имён App, соответствующее стандарту PSR-4. В этом случае Composer только регистрирует автозагрузчик, который подключает файлы с классами по необходимости, только во время их использования.

Все примеры на Хекслете используют автозагрузку классов. Рекомендую подглядывать в фай�� composer.json каждой практики и анализировать содержимое. Кроме того, понимать автозагрузку лучше всего не через внимательное чтение документации, а через эксперименты. Попробуйте самостоятельно собрать простой PHP-пакет и создайте внутри него классы. Не забывайте, что всегда можно подглядывать в наш шаблон.