Rivalry2

HTML Diff

1 added 1 removed

Original 2026-01-01

Modified 2026-02-26

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

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

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

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

5 либо так:

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

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

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

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

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

11 <ul><li>Префикс: Acme\Log\Writer</li>

12 <li>Базовая директория:./acme-log-writer/lib/</li>

13 <li>Результирующий путь:./acme-log-writer/lib/File_Writer.php</li>

14 </ul>Полное имя \Zend\Acl:

15 <ul><li>Префикс: Zend</li>

16 <li>Базовая директория:/usr/includes/Zend/</li>

17 <li>Результирующий путь:/usr/includes/Zend/Acl.php</li>

18 </ul>Полное имя \Symfony\Core\Request:

19 <ul><li>Префикс: Symfony\Core</li>

20 <li>Базовая директория:./vendor/Symfony/Core/</li>

21 <li>Результирующий путь:./vendor/Symfony/Core/Request.php</li>

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

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

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