Эффективное управление загрузкой классов PHP с помощью менеджера зависимостей Composer

Расширенные примеры настройки автозагрузки Composer

Пример 1: Несколько пространств имён, указывающих на разные директории

В одном проекте можно определить несколько префиксов PSR-4, ведущих к разным папкам. Это удобно, когда основные классы приложения лежат в src/, а классы для тестов в tests/.

{
    "autoload": {
        "psr-4": {
            "App\\": "src/",
            "App\\Tests\\": "tests/"
        }
    },
    "autoload-dev": {
        "psr-4": {
            "App\\Tests\\": "tests/"
        }
    }
}

Автозагрузка для тестов будет активна только в dev-окружении (при composer install --no-dev секция autoload-dev игнорируется).

Пример 2: Автозагрузка с оптимизацией через classmap и PSR-4 вместе

Можно комбинировать методы: PSR-4 для быстрой разработки, а classmap для продакшена. В composer.json указываются обе секции, а при генерации оптимизированной автозагрузки классы из PSR-4 попадают в карту.

{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        },
        "classmap": [
            "src/Legacy/"
        ]
    }
}

Классы из src/Legacy/ будут добавлены в карту, остальные загружаться по PSR-4. Команда composer dump-autoload -o создаст единую карту, включающую и то и другое.

Пример 3: Исключение директорий из classmap

При сканировании папок для classmap можно исключить определённые подпапки с помощью секции exclude-from-classmap.

{
    "autoload": {
        "classmap": ["src/"],
        "exclude-from-classmap": [
            "src/Tests/"
        ]
    }
}

Это предотвращает включение тестовых классов в автозагрузку продакшена.

Пример 4: Автозагрузка файлов с функциями в пакетах

При создании собственного пакета (composer-пакета) в composer.json можно указать файлы, которые будут автоматически подключаться при установке пакета.

{
    "name": "vendor/my-package",
    "autoload": {
        "files": [
            "src/functions.php"
        ]
    }
}

Пользователи, установившие пакет, получат эти функции без дополнительных действий.

Пример 5: Что находится внутри vendor/composer после dump-autoload

После генерации автозагрузки в директории vendor/composer появляются несколько файлов. Рассмотрим структуру:

vendor/composer/
├── autoload_classmap.php
├── autoload_files.php
├── autoload_namespaces.php
├── autoload_psr4.php
├── autoload_real.php
├── autoload_static.php
├── ClassLoader.php
└── LICENSE

# Список файлов после `composer dump-autoload -o`

Пример 6: Настройка автозагрузки для корпоративного стандарта с несколькими префиксами

Предположим, организация использует неймспейсы вида OrgName\ProjectName\Module. В composer.json:

{
    "autoload": {
        "psr-4": {
            "OrgName\\ProjectName\\": "src/"
        }
    }
}

Класс OrgName\ProjectName\Utils\Helper будет лежать в src/Utils/Helper.php.

Пример 7: Использование автозагрузки для micro-framework без Composer

Для демонстрации ручного автозагрузчика с несколькими префиксами:

<?php
spl_autoload_register(function ($class) {
    $prefixes = [
        'Framework\\' => __DIR__ . '/framework/',
        'App\\'       => __DIR__ . '/app/',
    ];
    foreach ($prefixes as $prefix => $baseDir) {
        $len = strlen($prefix);
        if (strncmp($prefix, $class, $len) === 0) {
            $relativeClass = substr($class, $len);
            $file = $baseDir . str_replace('\\', '/', $relativeClass) . '.php';
            if (file_exists($file)) {
                require $file;
                return;
            }
        }
    }
});

Этот код обрабатывает два префикса, загружая классы из соответствующих папок.

Пример 8: Ошибка из-за неправильного пути в PSR-4 и её диагностика

Если в composer.json указан путь, не соответствующий физическому расположению файлов, автозагрузка не сработает. Типичная ошибка - забыть указать слеш в конце префикса или указать неверный каталог.

// composer.json
{
    "autoload": {
        "psr-4": {
            "App\\": "source/"   // классы лежат в src/, а не source/
        }
    }
}

При попытке загрузить класс App\Models\User Composer будет искать файл source/Models/User.php, которого нет. Ошибка отобразится как "Class 'App\Models\User' not found". Решение - проверить composer.json и выполнить composer validate.

Пример 9: Профилирование автозагрузки с помощью xdebug

Если требуется проанализировать, какие файлы загружаются, можно включить трассировку. Включите xdebug, выполните скрипт:

<?php
require 'vendor/autoload.php';
// код приложения

// После выполнения смотреть лог xdebug

Также можно использовать встроенную статистику Composer: composer dump-autoload --no-dev -v выводит информацию о загруженных классах.

Пример 10: Использование Composer для автозагрузки в консольных скриптах

Для скриптов, запускаемых из командной строки, достаточно тем же способом подключить autoload.php. Пример скрипта bin/console.php:

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

use Symfony\Component\Console\Application;
$application = new Application();
// ... настройка команд
$application->run();