Если вы хотите, чтобы ваш PHP-код загружался быстрее, особенно на продакшене, стоит обратить внимание на оптимизацию автозагрузки. Ниже — что это значит и как настроить.
🔍 Что такое оптимизация автозагрузки в Composer
По умолчанию Composer формирует автозагрузчик так, чтобы было удобно в разработке — он может на лету проверять файловую систему, искать файлы классов и т.д. Но это добавляет накладные расходы при каждом запросе.
Чтобы ускорить автозагрузку, Composer предлагает несколько уровней оптимизации:
Уровень 1 — Class map generation: вместо PSR-4/PSR-0 правил генерируется готовая карта классов (classmap), что позволяет автозагрузчику сразу «знать», где находится файл.
Уровень 2/A — Authoritative class maps: означает, что если класс не найден в classmap — дальнейшем поиску по файловой системе не доверяют. Это ещё быстрее, но требует, чтобы все классы были заранее включены в карту.
Уровень 2/B — APCu cache fallback: использует APCu-кеш для кеширования “класс найден / не найден”, ускоряя автозагрузку без полного отключения файловой системы.
⚙️ Как правильно настроить
Вот шаги, которые можно выполнить в вашем проекте:
1. В
composer.json добавьте в раздел "config":"config": {
"optimize-autoloader": true
}Это включает optimisation level 1.
2. При установке/обновлении запустите Composer с флагом
-o / --optimize-autoloader (или -o):composer install --no-dev -o
Если вы на продакшене — лучше исключить пакеты для разработки (
--no-dev). 3. Для ещё большей оптимизации (если вы уверены, что структура проекта окончательная и классов добавляться не будет “по-ходу”):
composer dump-autoload --classmap-authoritative --no-dev
Это включает уровень 2/A.
4. Если доступен APCu, можно рассмотреть вариант 2/B:
composer install --optimize-autoloader --apcu-autoloader
Но тут нужно, чтобы APCu был установлен и настроен.
🧠 Когда это применять и на что обратить внимание
✅ На продакшене — оптимизация автозагрузки почти всегда повышение производительности, особенно в больших проектах.
⚠️ В разработке — будьте осторожны: если вы часто добавляете/удаляете/переименовываете классы, оптимизированный classmap может “не видеть” новые файлы до повторного
dump-autoload. 📂 Убедитесь, что все классы соответствуют PSR-4/PSR-0 и названы корректно — иначе могут быть проблемы при уровне 2 оптимизации.
🐸 Библиотека пхпшника