Поиск
Ошибки

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.

≈ 8 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Найдите своё сообщение в таблице.
  2. Если composer.json меняли, запустите composer update там, где разрабатываете сайт, — или composer update имя/пакета для одной библиотеки.
  3. Перенесите на сервер composer.json и composer.lock вместе и запустите там composer install.

Что такое composer.lock

ФайлЧто в нёмКакая команда его меняет
composer.jsonкакие библиотеки нужны и какие версии подходят, например ^2.4вы или composer require
composer.lockкакие точные версии подобраны, например 2.4.1composer 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 --lock
composer 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:

На рабочем сервере подсказка 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.jsoncomposer.json поменяли после composer updatecomposer 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.

Источники

Сверено 13 ноября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше