diff --git a/cookbook/upgrade/_update_all_packages.rst.inc b/cookbook/upgrade/_update_all_packages.rst.inc index 95e1c63f954..ad4c51c6d49 100644 --- a/cookbook/upgrade/_update_all_packages.rst.inc +++ b/cookbook/upgrade/_update_all_packages.rst.inc @@ -1,3 +1,6 @@ +Upgrading other Packages +~~~~~~~~~~~~~~~~~~~~~~~~ + You may also want to upgrade the rest of your libraries. If you've done a good job with your `version constraints`_ in ``composer.json``, you can do this safely by running: diff --git a/cookbook/upgrade/_update_dep_errors.rst.inc b/cookbook/upgrade/_update_dep_errors.rst.inc new file mode 100644 index 00000000000..663c0091f58 --- /dev/null +++ b/cookbook/upgrade/_update_dep_errors.rst.inc @@ -0,0 +1,19 @@ +Dependency Errors +~~~~~~~~~~~~~~~~~ + +If you get a dependency error, it may simply mean that you need to upgrade +other Symfony dependencies too. In that case, try the following command: + + $ composer update symfony/symfony --with-dependencies + +This updates ``symfony/symfony`` and *all* packages that it depends on, which will +include several other packages. By using tight version constraints in +``composer.json``, you can control what versions each library upgrades to. + +If this still doesn't work, your ``composer.json`` file may specify a version +for a library that is not compatible with the newer Symfony version. In that +case, updating that library to a newer version in ``composer.json`` may solve +the issue. + +Or, you may have deeper issues where different libraries depend on conflicting +versions of other libraries. Check your error message to debug. diff --git a/cookbook/upgrade/major_version.rst b/cookbook/upgrade/major_version.rst index 10fcafbbf83..9f2a52e183c 100644 --- a/cookbook/upgrade/major_version.rst +++ b/cookbook/upgrade/major_version.rst @@ -98,6 +98,8 @@ Next, use Composer to download new versions of the libraries: $ composer update symfony/symfony +.. include:: /cookbook/upgrade/_update_dep_errors.rst.inc + .. include:: /cookbook/upgrade/_update_all_packages.rst.inc .. _upgrade-major-symfony-after: diff --git a/cookbook/upgrade/minor_version.rst b/cookbook/upgrade/minor_version.rst index 55b63bb0580..78f829e2a3b 100644 --- a/cookbook/upgrade/minor_version.rst +++ b/cookbook/upgrade/minor_version.rst @@ -41,6 +41,8 @@ Next, use Composer to download new versions of the libraries: $ composer update symfony/symfony +.. include:: /cookbook/upgrade/_update_dep_errors.rst.inc + .. include:: /cookbook/upgrade/_update_all_packages.rst.inc .. _`upgrade-minor-symfony-code`: