Почти все современные PHP-проекты управляются через Composer. Laravel, Symfony или собственный фреймворк — в папке vendor обычно лежат десятки, а то и сотни пакетов, и большинство из них вы не выбирали осознанно: они пришли как зависимости других пакетов. Каждый такой пакет работает на сервере с теми же правами, что и ваш код. Поэтому уязвимость в любом из них становится проблемой всего сайта. В статье разберём, как регулярно проверять пакеты Composer, не допускать опасных изменений и правильно выкладывать проект на сервер.
composer audit: известные уязвимости одной командой
Начиная с Composer 2.4 есть команда audit. Она сверяет точные версии из composer.lock с открытыми базами уязвимостей и выводит список проблемных пакетов. Для каждой находки показываются описание, уровень серьёзности и затронутые версии. Если ваш Composer старый, сначала обновите его: сам Composer тоже время от времени получает исправления безопасности.
# проверить и обновить версию Composer
composer --version
composer self-update
# проверка уязвимостей по lock-файлу
composer audit
# только production-пакеты
composer audit --no-dev
# короткий формат для CI
composer audit --format=plain
Если composer audit находит уязвимость, он завершается с ненулевым кодом, поэтому его легко добавить в CI: сборка с уязвимым пакетом не попадёт на сервер. Кроме того, в Composer 2.x команды composer update и composer require тоже показывают краткий итог аудита в конце — не игнорируйте эти предупреждения.
Почему composer.lock обязан быть в репозитории
В composer.json обычно записаны диапазоны вроде ^10.0, то есть допустимый интервал версий. А composer.lock фиксирует, какая именно версия установлена, вплоть до коммита и хеша архива. Если lock-файла в репозитории нет, каждый composer install на сервере тянет самые свежие на тот момент версии, и код на сервере начинает отличаться от проверенного на машине разработчика. Это приводит не только к ошибкам, но и к тому, что к вам незаметно попадает новая, ещё никем не проверенная версия.
Правильный порядок прост: обновляетесь вы только локально или в тестовой среде через composer update, проверяете результат, отправляете lock-файл в репозиторий, а на сервере используете только composer install. Тогда на сервер попадают ровно те версии, которые вы протестировали.
Как найти устаревшие и заброшенные пакеты
Опасен и пакет, для которого уязвимость ещё не зарегистрирована, но который годами не обновлялся. В нём не исправляют ошибки, а иногда его помечают заброшенным и рекомендуют замену. Composer показывает такие случаи — нужно только читать вывод.
# устаревшие среди прямых зависимостей
composer outdated --direct
# кому нужен конкретный пакет
composer why vendor/package
composer show --tree
# проверка корректности composer.json
composer validate --strict
В выводе composer outdated обращайте особое внимание на пакеты с большим отставанием по мажорной версии. Если пакет помечен как "abandoned", Composer предупредит об этом при установке и покажет рекомендуемую замену. Запланируйте замену такого пакета как можно раньше.
Скрипты и плагины: Composer тоже исполняет код
Composer не только скачивает файлы. Раздел scripts в composer.json и плагины Composer выполняют код при установке и обновлении. С версии 2.2 появилась настройка allow-plugins: плагин, которого нет в списке, не запускается, и Composer спрашивает разрешение. Добавляйте туда только действительно нужные и доверенные плагины.
{
"config": {
"allow-plugins": {
"php-http/discovery": false,
"pestphp/pest-plugin": true
},
"secure-http": true
}
}
При первой установке чужого или сомнительного проекта можно запустить composer install --no-scripts --no-plugins и сначала прочитать скрипты в composer.json. Настройка secure-http включена по умолчанию и не позволяет скачивать пакеты по незашифрованному HTTP — не отключайте её.
Полный запрет на установку уязвимых версий
Многие команды используют пакет roave/security-advisories. Он не добавляет кода, а лишь объявляет конфликт с известными уязвимыми версиями. В результате Composer просто отказывается их устанавливать, и вы видите проблему ещё до деплоя.
composer require --dev roave/security-advisories:dev-latest
Правильный деплой на сервер
На production-сервере инструменты разработки не нужны — они лишь расширяют поверхность атаки, поэтому устанавливайте с --no-dev. Кроме того, корневая папка сайта (document root) должна указывать на папку public проекта, чтобы vendor, .env и composer.json не открывались из браузера.
composer install --no-dev --optimize-autoloader --no-interaction
# проверка: эти адреса должны отдавать 403 или 404
curl -I https://example.uz/vendor/autoload.php
curl -I https://example.uz/.env
curl -I https://example.uz/composer.lock
Пример: система онлайн-записи частной клиники в Намангане была написана на Laravel. Файлы проекта целиком лежали в public_html, то есть document root указывал на корень проекта, и файл .env открывался в браузере. Lock-файл к тому же годами не обновлялся, а composer audit показал несколько известных уязвимостей. Чтобы исправить ситуацию, document root перенесли на папку public, сменили все пароли и ключи из .env, обновили пакеты в тестовой среде и лишь затем установили их на сервер с --no-dev.
Регулярный порядок
Разовой проверки недостаточно: новые уязвимости публикуются каждую неделю. Запускайте composer audit хотя бы раз в месяц, а в идеале перед каждым деплоем, и не оставляйте результат без внимания. Помогает и автоматическое обновление зависимостей в сервисах репозиториев: для каждой новой версии они предлагают отдельное изменение, которое вы тестируете и принимаете. Если у вас есть вопросы о работе с SSH и Composer на хостинге sayt.uz, уточните их через личный кабинет или техническую поддержку. Если Composer на сервере нет, можно собрать проект локально с --no-dev и загрузить его вместе с готовой папкой vendor.