Зарегистрируйтесь для доступа к 15+ бесплатным курсам по программированию с тренажером

Автозагрузка классов PHP: Введение в ООП

Принято определять ровно один класс на файл. Более того, в этом файле больше не может быть никаких инструкций, не считая определения пространств имён. Чисто технически, язык не запрещает нарушать это правило, но лучше следовать стандартам кодирования 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-пакет и создайте внутри него классы. Не забывайте, что всегда можно подглядывать в наш шаблон.


Дополнительные материалы

  1. Официальная документация

Аватары экспертов Хекслета

Остались вопросы? Задайте их в разделе «Обсуждение»

Вам ответят команда поддержки Хекслета или другие студенты

Для полного доступа к курсу нужен базовый план

Базовый план откроет полный доступ ко всем курсам, упражнениям и урокам Хекслета, проектам и пожизненный доступ к теории пройденных уроков. Подписку можно отменить в любой момент.

Получить доступ
1000
упражнений
2000+
часов теории
3200
тестов

Открыть доступ

Курсы программирования для новичков и опытных разработчиков. Начните обучение бесплатно

  • 130 курсов, 2000+ часов теории
  • 1000 практических заданий в браузере
  • 360 000 студентов
Отправляя форму, вы принимаете «Соглашение об обработке персональных данных» и условия «Оферты», а также соглашаетесь с «Условиями использования»

Наши выпускники работают в компаниях:

Логотип компании Альфа Банк
Логотип компании Aviasales
Логотип компании Yandex
Логотип компании Tinkoff
Рекомендуемые программы
профессия
от 25 000 ₸ в месяц
Разработка веб-приложений на Laravel
10 месяцев
с нуля
Старт 28 ноября

Используйте Хекслет по-максимуму!

  • Задавайте вопросы по уроку
  • Проверяйте знания в квизах
  • Проходите практику прямо в браузере
  • Отслеживайте свой прогресс

Зарегистрируйтесь или войдите в свой аккаунт

Отправляя форму, вы принимаете «Соглашение об обработке персональных данных» и условия «Оферты», а также соглашаетесь с «Условиями использования»