Как подключать классы в PHP: от ручного включения до автоматической загрузки

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

Пример 1. Ручное подключение нескольких классов из разных директорий

<?php
// Подключаем классы вручную
require 'lib/Database.php';
require 'lib/Logger.php';
require 'models/User.php';
require 'controllers/AuthController.php';

// Используем классы
$db = new Database();
$log = new Logger();
$user = new User($db);
$auth = new AuthController($db, $log);
?>

Пояснение: каждый файл подключается явно. Если один из классов используется внутри другого, порядок подключения важен. Типичная ошибка: если класс B использует класс A, а A подключён после B, возникнет ошибка. Требуется тщательно следить за графом зависимостей.

Пример 2. Условное подключение класса через include

<?php
$useCustomMailer = true;
if ($useCustomMailer) {
    include 'mailers/CustomMailer.php';
} else {
    include 'mailers/DefaultMailer.php';
}

$mailer = $useCustomMailer ? new CustomMailer() : new DefaultMailer();
?>

Пояснение: include позволяет загрузить файл только по условию. Если файла не существует, PHP выдаёт предупреждение, но скрипт продолжает работу. Это полезно для подключаемых модулей, но может привести к скрытым ошибкам.

Пример 3. Автозагрузка через spl_autoload_register с несколькими директориями

<?php
spl_autoload_register(function ($class) {
    $paths = [
        __DIR__ . '/src/',
        __DIR__ . '/lib/',
        __DIR__ . '/vendor/mylib/',
    ];

    foreach ($paths as $dir) {
        $file = $dir . $class . '.php';
        if (file_exists($file)) {
            require_once $file;
            return;
        }
    }
});

$obj = new MyClass(); // будет искаться в src/, lib/, vendor/mylib/
?>

Пояснение: автозагрузчик последовательно проверяет несколько директорий. Этот подход удобен, когда классы разбросаны по разным папкам, но не хочется использовать пространства имён. Недостаток: снижение производительности при большом количестве директорий.

Пример 4. Использование Composer с PSR-4 для глубокой вложенности пространств имён

// composer.json
{
    "autoload": {
        "psr-4": {
            "MyApp\\": "app/",
            "MyApp\\Modules\\": "modules/"
        }
    }
}

После выполнения composer dump-autoload автозагрузчик будет искать класс MyApp\Modules\Blog\Post в файле modules/Blog/Post.php. Пример использования:

<?php
require 'vendor/autoload.php';

use MyApp\Modules\Blog\Post;
$post = new Post();
?>

Пояснение: PSR-4 упрощает рефакторинг: перенос класса в другую папку не требует изменения кода, только обновление map. Composer генерирует оптимизированную карту классов (classmap) для быстрой загрузки.

Пример 5. Автозагрузка с поддержкой classmap (быстрая загрузка)

Composer позволяет использовать стратегию classmap, которая сканирует все PHP-файлы в указанных директориях и создаёт ассоциативный массив (класс => путь). Это быстрее PSR-4, но менее гибко.

// composer.json
{
    "autoload": {
        "classmap": [
            "src/",
            "lib/"
        ]
    }
}

После composer dump-autoload -o будет сгенерирован оптимизированный файл автозагрузки. Все классы из папок src/ и lib/ будут загружаться быстрее, так как путь уже известен.

Пример 6. Использование автозагрузчика для работы с устаревшими классами (без пространств имён)

<?php
spl_autoload_register(function ($class) {
    // Маппинг имён классов на файлы
    $map = [
        'OldLibrary' => __DIR__ . '/vendor/OldLibrary/OldLibrary.php',
        'LegacyHelper' => __DIR__ . '/helpers/LegacyHelper.php',
    ];

    if (isset($map[$class])) {
        require_once $map[$class];
    }
});

$obj = new OldLibrary(); // сразу знаем путь
?>

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

Пример 7. Обработка ошибок при автозагрузке

<?php
spl_autoload_register(function ($class) {
    $file = __DIR__ . '/classes/' . str_replace('\\', '/', $class) . '.php';
    if (!file_exists($file)) {
        // Можно бросить исключение или вернуть false
        throw new Exception("Class $class not found in $file");
    }
    require $file;
});

try {
    $obj = new NonExistentClass();
} catch (Exception $e) {
    echo $e->getMessage(); // Class NonExistentClass not found ...
}
?>

Пояснение: вместо фатальной ошибки можно контролировать процесс загрузки и генерировать исключения. Это полезно при разработке фреймворков, где требуется логирование.

Пример 8. Последовательное подключение нескольких автозагрузчиков

<?php
// Первый автозагрузчик - для классов проекта
spl_autoload_register(function ($class) {
    $file = __DIR__ . '/src/' . $class . '.php';
    if (file_exists($file)) {
        require $file;
        return true;
    }
    return false;
});

// Второй автозагрузчик - для внешней библиотеки
spl_autoload_register(function ($class) {
    $file = __DIR__ . '/vendor/MyLib/' . $class . '.php';
    if (file_exists($file)) {
        require $file;
        return true;
    }
    return false;
});

$obj1 = new MyApp\Controller(); // загружается первым
$obj2 = new MyLib\SomeClass();  // загружается вторым
?>

Пояснение: регистрируется несколько автозагрузчиков. PHP перебирает их по порядку, пока один из них не загрузит класс. Если ни один не загрузил, возникает фатальная ошибка.