Принято определять ровно один класс на файл. Более того, в этом файле больше не может быть никаких инструкций, не считая определения пространств имён. Чисто технически, язык не запрещает нарушать это правило, но лучше следовать стандартам кодирования PSR-12.
Классы немного по-другому работают с пространствами имён. Если пространство имён содержит только функции, то его определение обычно оканчивается именем файла (без расширения). Во всех наших упражнениях именно такая структура.
<?php
// file: src/solution.php
namespace App\solution;
function ...
В случае с классами, пространство имён не содержит имени файла. Его роль выполняет само название класса. Причём файл должен называться в точности как класс и с учётом регистра.
<?php
// file: src/Point.php
namespace App;
class Point
{
}
Использовать этот класс в другом пространстве имён можно так:
<?php
namespace AnotherApp;
use App\Point;
$point = new Point();
либо так:
<?php
namespace AnotherApp;
$point = new \App\Point();
Полное описание требований к тому, как правильно стилистически именовать классы и как соотносить их с файловой структурой, приведено в стандарте PSR-4. Этот стандарт важно соблюдать по двум причинам. Первая связана с единым подходом к именованию и формированию структуры, что позволяет легко ориентироваться в проектах. Но есть и другая, не менее важная причина — автозагрузка классов.
Если определённое пространство имён в PHP содержит только функции, то для его загрузки используется специальная секция autoload/files в файле composer.json.
"autoload": {
"files": [
"src/Points.php",
"src/Segments.php"
]
}
Эту секцию вы могли видеть практически в каждой практике на Хекслете. Composer требует перечисления всех таких файлов, и только в этом случае он загрузит их автоматически. Причём произойдёт это в любом случае, неважно, используются функции этих пространств имён или нет.
<?php
// Эта строчка приводит к загрузке всех файлов, указанных в секции files
require __DIR__ . '/../vendor/autoload.php';
С классами ситуация другая. 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
{
"autoload": {
"psr-4": {"App\\": "src/"}
}
}
В данном примере указано, что в директории src относительно расположения файла composer.json находится пространство имён App, соответствующее стандарту PSR-4. В этом случае Composer только регистрирует автозагрузчик, который подключает файлы с классами по необходимости, только во время их использования.
Все примеры на Хекслете используют автозагрузку классов. Рекомендую подглядывать в файл composer.json каждой практики и анализировать содержимое. Кроме того, понимать автозагрузку лучше всего не через внимательное чтение документации, а через эксперименты. Попробуйте самостоятельно собрать простой PHP-пакет и создайте внутри него классы. Не забывайте, что всегда можно подглядывать в наш шаблон.
Дополнительные материалы
Остались вопросы? Задайте их в разделе «Обсуждение»
Вам ответят команда поддержки Хекслета или другие студенты
Для полного доступа к курсу нужен базовый план
Базовый план откроет полный доступ ко всем курсам, упражнениям и урокам Хекслета, проектам и пожизненный доступ к теории пройденных уроков. Подписку можно отменить в любой момент.
