Composer: The lock file is not up to date with the latest changes in composer.json — что делать
composer.lock — список точных версий библиотек, который создаёт composer update, а composer install ставит. Если composer.json поменяли, а composer.lock — нет, Composer предупреждает: список устарел. Решение — composer update там, где разрабатывают сайт, затем перенести на сервер оба файла и запустить composer install.
Содержание 10
Что сделать прямо сейчас
- Найдите своё сообщение в таблице.
- Если composer.json меняли, запустите
composer updateтам, где разрабатываете сайт, — илиcomposer update имя/пакетадля одной библиотеки. - Перенесите на сервер composer.json и composer.lock вместе и запустите там
composer install.
Что такое composer.lock
| Файл | Что в нём | Какая команда его меняет |
|---|---|---|
| composer.json | какие библиотеки нужны и какие версии подходят, например ^2.4 | вы или composer require |
| composer.lock | какие точные версии подобраны, например 2.4.1 | composer update и composer require |
composer install ставит библиотеки ровно тех версий, что записаны в composer.lock. Так на сервере оказываются те же версии, что у разработчика. Поэтому оба файла переносят на сервер вместе, а на рабочем сервере запускают composer install, а не composer update.
Если lock-файл устарел
Warning: The lock file is not up to date with the latest changes in composer.json. You may be getting outdated dependencies. It is recommended that you run `composer update` or `composer update <package name>`.«Lock-файл не учитывает последние изменения в composer.json. Вы можете получить устаревшие библиотеки. Рекомендуем запустить composer update или composer update имя/пакета».
Это предупреждение, а не ошибка: Composer продолжит и поставит версии из composer.lock, но новых изменений composer.json не учтёт.
В composer.lock записан отпечаток composer.json — строка content-hash. В него входят списки библиотек require и require-dev, разделы repositories, extra, conflict, replace, provide, настройки minimum-stability, prefer-stable и config → platform. Если любую из этих частей поменяли после composer update, отпечаток не совпадёт. Так бывает, если composer.json поправили вручную или перенесли на сервер новый composer.json со старым composer.lock.
Что сделать:
- Там, где разрабатываете сайт, запустите
composer update имя/пакетадля библиотеки, которую меняли, илиcomposer updateдля всех. Затем перенесите на сервер оба файла и запуститеcomposer install. - Если поменяли то, что не касается библиотек, — например, раздел
extra, — обновите только отпечаток, версии останутся прежними:
composer update --lockcomposer update на рабочем сервере меняет версии библиотек прямо на сайте. Если запускаете его там, сначала сделайте копию папки проекта и базы — резервные копии.Если пакета нет в lock-файле
- Required package "example/library" is not present in the lock file.
This usually happens when composer files are incorrectly merged or the composer.json file is manually edited.«Нужного пакета example/library нет в lock-файле. Так бывает, когда файлы Composer неправильно объединили при слиянии веток или composer.json поправили вручную». Ниже Composer даёт ссылки на документацию: как разрешать конфликты слияния и почему библиотеки лучше добавлять командой composer require.
Здесь example/library — пример имени. Если пакет нужен только для разработки, строка начинается с Required (in require-dev).
Похожая строка — когда пакет в lock-файле есть, но не той версии:
- Required package "example/library" is in the lock file as "1.2.0" but that does not satisfy your constraint "^2.0".«Пакет записан в lock-файле с версией 1.2.0, а composer.json просит ^2.0».
В обоих случаях Composer ничего не ставит, код выхода — 4. Что сделать: запустите composer update example/library — Composer подберёт версию и запишет её в composer.lock. Дальше — как выше: перенесите оба файла на сервер.
Если composer.lock нет
No composer.lock file present. Updating dependencies to latest instead of installing from lock file. See https://getcomposer.org/install for more information.«Файла composer.lock нет. Ставлю самые новые подходящие версии, а не версии из lock-файла». composer install в этом случае работает как composer update: подбирает версии сам и создаёт composer.lock. Версии могут отличаться от тех, с которыми сайт проверял разработчик.
Что сделать: возьмите composer.lock там же, где брали код сайта, — у разработчика или в репозитории, — положите рядом с composer.json и запустите composer install снова.
Если без lock-файла запустить composer update имя/пакета, Composer остановится:
Cannot update only a partial set of packages without a lock file present. Run `composer update` to generate a lock file.«Нельзя обновить часть пакетов без lock-файла, запустите composer update». Код выхода — 3.
Если версии из composer.lock не подходят серверу
Your lock file does not contain a compatible set of packages. Please run composer update.
Problem 1
- …«В lock-файле нет набора пакетов, который подходит этому серверу. Запустите composer update». Ниже — блок Problem 1 с причиной, как при ошибке Your requirements could not be resolved. Причина бывает в PHP или в модуле PHP: composer.lock собрали на компьютере, где PHP новее или есть модули, которых нет на сервере. Composer ничего не ставит, код выхода — 2.
Что сделать — по строке под Problem 1:
your php version (…) does not satisfy— PHP на сервере старее: разбор. Разработчик может указать Composer версию PHP сервера — настройка platform.it is missing from your system— на сервере нет модуля PHP: какой пакет поставить.
На рабочем сервере подсказка Please run composer update поменяет версии библиотек. Сначала попробуйте поставить модуль или нужную PHP.
Похожее сообщение:
Your lock file cannot be installed on this system without changes. Please run composer update.«Lock-файл нельзя поставить на этот сервер без изменений». Код выхода — 4. Что делать — то же: проверьте PHP и модули командой из раздела ниже.
Как проверить заранее
Подходит ли composer.lock серверу, покажет команда — запустите её на сервере в папке проекта до composer install:
composer check-platform-reqs --lockОна сравнивает версию PHP и модули с требованиями библиотек из composer.lock. В каждой строке — требование и итог: success — подходит, missing — нет на сервере, failed — есть, но не той версии.
Совпадает ли composer.lock с composer.json, покажет composer validate. Если lock-файл устарел, в ответе будет строка:
- The lock file is not up to date with the latest changes in composer.json, it is recommended that you run `composer update` or `composer update <package name>`.Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Warning: The lock file is not up to date with the latest changes in composer.json | composer.json поменяли после composer update | composer update и оба файла на сервер |
Required package "…" is not present in the lock file. | пакет добавили в composer.json вручную | composer update имя/пакета |
is in the lock file as "…" but that does not satisfy your constraint | в composer.json поменяли версию | composer update имя/пакета |
No composer.lock file present. | lock-файла нет | возьмите composer.lock у разработчика |
Cannot update only a partial set of packages without a lock file present. | обновление одного пакета без lock-файла | composer update |
Your lock file does not contain a compatible set of packages. | версии из lock-файла не подходят серверу | проверьте PHP и модули |
Your lock file cannot be installed on this system without changes. | lock-файл не ставится без изменений | проверьте PHP и модули |
Тексты сообщений сверены по исходному коду Composer 2.7.1 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код Composer 2.7.1 — на английском: сообщения в Installer.php и Package/Locker.php, отпечаток content-hash.
- Основы работы с Composer — на английском: что такое composer.lock и зачем он нужен.
- Команды Composer — на английском: update --lock, check-platform-reqs --lock и validate.
- Конфликты слияния — на английском: как объединять composer.lock из разных веток.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Your requirements could not be resolvedкак читать блок Problem.
- Your php version does not satisfy that requirementесли серверу нужна другая PHP.
- Ошибки Composerвсе ошибки Composer на одной странице.