diff --git a/CHANGELOG.md b/CHANGELOG.md index e59069f..2e5e110 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ### Fixed +- `UPGRADE-6.0.md` opens with `composer require …:^6.0` rather than + `composer update`, which cannot cross the major consumers pin and so reported + nothing to do. - `actions/checkout` updated from v6 to v7 across every workflow. `codecov/codecov-action` was already current. - `getContainerExtension()` no longer returns `mixed` on Symfony 6.4, which declares diff --git a/UPGRADE-6.0.md b/UPGRADE-6.0.md index ff57b1d..0fa75e1 100644 --- a/UPGRADE-6.0.md +++ b/UPGRADE-6.0.md @@ -6,14 +6,23 @@ applications already satisfy the first, in which case there is nothing to change you catch `AuthenticationException` around the callback. ```sh -composer update itk-dev/openid-connect-bundle +composer require itk-dev/openid-connect-bundle:^6.0 ``` +`require`, not `update`: your `composer.json` pins a major — `^5.0` or similar — and +`composer update` will not cross it, so it would report nothing to do and leave you on +5.x wondering why none of this applies. + Coming from 4.x? Do [UPGRADE-5.0.md](UPGRADE-5.0.md) first — this guide assumes 5.x. On -that hop the library moves too and a partial update refuses (`the package is fixed to -4.1.2 (lock file version) by a partial update`), so name both packages. From 5.x the -bundle alone is enough: the only requirement that changes is `symfony/deprecation-contracts`, -which is dropped. +that hop the library moves with the bundle, and naming the bundle alone refuses with +`the package is fixed to 4.1.2 (lock file version) by a partial update`, so name both: + +```sh +composer require itk-dev/openid-connect-bundle:^5.0 itk-dev/openid-connect:^5.0 +``` + +From 5.x to 6.0 the bundle alone is enough: the only requirement that changes is +`symfony/deprecation-contracts`, which is dropped. ## 1. Declare where each callback arrives