Update Laminas packages (major) #92

laminas-servicemanager 4.0.0 is here and finally enables projects to consume psr/container v2.0.0 after 2 years along with several type-additions and plugin manager decoupling.

The migration guide is not written yet but will be at some point (once we added support for SM v4 to other components) later.

Added

Several native type-additions including property-, argument- and return-types and a lot more psalm types
ServiceManager#get, PluginManagerInterface#get and ServiceLocatorInterface#build now explicitly implement mixed as return-type to synchronize types with ContainerInterface#get
Support for psr/container v1.1 and v2.0
Ahead of Time factory creation for services explicitly using ReflectionBasedAbstractFactory via laminas-cli

Removed

Dropped support for PHP <8.1
Removed deprecated interfaces such as
- Laminas\ServiceManager\AbstractFactoryInterface
- Laminas\ServiceManager\FactoryInterface
- Laminas\ServiceManager\InitializerInterface
- Laminas\ServiceManager\DelegatorFactoryInterface
CLI commands which were exposed via vendor/bin are removed in favor of the laminas-cli integration. All CLI commands of v3.x are accessible via vendor/bin/laminas servicemanager:<v3.x command name> once laminas/laminas-cli is required in the projects dependencies
Removed deprecated ConfigInterface and Config-class since these files did not provide any validation logic and were just used to proxy the configuration array structure
Removed AbstractPluginManager#validate and AbstractPluginManager::$instanceOf property as in v3.x, implementing plugin managers were able to implicitly validate mixed. In case an implementing plugin manager is providing a single $instanceOf such as laminas-cache, there is a new class AbstractSingleInstancePluginManager available which requires the $instanceOf property to be configured

Breaking Changes

AbstractPluginManager does not extend ServiceManager anymore and instead uses an own ServiceManager instance under the hood to manage plugin manager related services which can be configured the same way as in v3.x
Dedicated CLI commands which were previously linked to vendor/bin are now integrated via laminas-cli and can be called via vendor/bin/laminas once laminas/laminas-cli is part of the projects requirements. Read more about how to consume these commands here.
AbstractPluginManager does not provide the validate-Method anymore and requires migration action such as:
- extend AbstractSingleInstancePluginManager in case the plugin manager only provides instances of a specific interface- or class-string (please be aware that the $instanceOf property now requires native string property type)
- implement validate method and verify whatever type has to be returned and/or just allow mixed as v3.x did when omitting $instanceOf property
Removed deprecated ConfigInterface and Config-class since these files did not provide any validation logic and were just used to proxy the configuration array structure
neither ServiceManager nor AbstractPluginManager do validate the provided configuration at runtime anymore. due to the psalm-types provided to ServiceManager#__construct, ServiceManager#configure, AbstractPluginManager#__construct and AbstractPluginManager#configure, the configuration schema is strictly typed and thus, a miss-configuration can be mitigated on static-analysis level prior actual runtime
AbstractPluginManager#get does not accept options anymore, in case an instance with options needs to be created, AbstractPluginManager#build has to be used

4.0.0

Total issues resolved: 7
Total pull requests resolved: 14
Total contributors: 6

Enhancement

204: Introduce plugin manager static analysis file thanks to @boesing
200: Replace scope to retrieve plugin manager from $this to self thanks to @boesing
194: Narrow return type of single instance plugin managers thanks to @boesing
187: Remove removed binaries from composer thanks to @boesing
171: AOT factory creation CLI command for ReflectionBasedAbstractFactory mapped factories thanks to @boesing
58: Merge release 3.5.0 into 4.0.x thanks to @github-actions[bot]

BC Break,Enhancement

191: Modernize codebase thanks to @boesing
188: Add support for psr/container v2 thanks to @boesing and @danielspk
181: Remove deprecated ServiceManager#getServiceLocator method thanks to @boesing
179: Remove ServiceManager inheritance for AbstractPluginManager thanks to @boesing
176: Convert old CLI standalone commands to laminas-cli commands thanks to @boesing
172: Convert commands to laminas-cli symfony commands thanks to @boesing
46: #44 add strict type declarations thanks to @GeeH

RFC

BC Break

170: Remove deprecated factories thanks to @boesing
169: Remove container-interop/container-interop polyfill thanks to @boesing

renovate

151: Update dependency psr/container to v2 thanks to @renovate[bot]

Bug

89: AbstractPluginManager::get has parameter name mismatch with ContainerInterface::get thanks to @Slamdunk

`v3.23.0`

Compare Source

Release Notes for 3.23.0

3.23.0

Total issues resolved: 0
Total pull requests resolved: 1
Total contributors: 1

Enhancement

243: Add PHP 8.4 Support to the 3.x series thanks to @gsteel

`v3.22.1`

Compare Source

Release Notes for 3.22.1

3.22.x bugfix release (patch)

3.22.1

Total issues resolved: 1
Total pull requests resolved: 1
Total contributors: 1

Enhancement

213: Narrow array type for services in ServiceManager configuration thanks to @rieschl

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

👻 Immortal: This PR will be recreated if closed unmerged. Get config help if that's undesired.

If you want to rebase/retry this PR, check this box

Read more information about the use of Renovate Bot within Laminas.

| datasource | package | from | to | | ---------- | ------------------------------- | ------ | ----- | | packagist | laminas/laminas-coding-standard | 2.5.0 | 3.0.0 | | packagist | laminas/laminas-servicemanager | 3.22.0 | 4.2.0 | Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

renovate · 2024-10-12T01:38:36Z

⚠️ Artifact update problem

Renovate failed to update an artifact related to this branch. You probably do not want to merge this PR as-is.

♻ Renovate will retry this branch, including artifacts, only when one of the following happens:

any of the package files in this branch needs updating, or
the branch becomes conflicted, or
you click the rebase/retry checkbox if found above, or
you rename this PR's title to start with "rebase!" to trigger it manually

The artifact failure details are included below:

File name: composer.lock

Command failed: composer update laminas/laminas-coding-standard:3.0.0 laminas/laminas-servicemanager:4.2.0 --with-dependencies --ignore-platform-req='ext-*' --ignore-platform-req='lib-*' --no-ansi --no-interaction --no-scripts --no-autoloader --no-plugins
Loading composer repositories with package information
Dependency squizlabs/php_codesniffer is also a root requirement. Package has not been listed as an update argument, so keeping locked at old version. Use --with-all-dependencies (-W) to include root dependencies.
Dependency laminas/laminas-stdlib is also a root requirement. Package has not been listed as an update argument, so keeping locked at old version. Use --with-all-dependencies (-W) to include root dependencies.
Dependency psr/container is also a root requirement. Package has not been listed as an update argument, so keeping locked at old version. Use --with-all-dependencies (-W) to include root dependencies.
Updating dependencies
Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - Root composer.json requires laminas/laminas-coding-standard ~3.0.0 -> satisfiable by laminas/laminas-coding-standard[3.0.0].
    - laminas/laminas-coding-standard 3.0.0 requires squizlabs/php_codesniffer ^3.10 -> found squizlabs/php_codesniffer[3.10.0, 3.10.1, 3.10.2, 3.10.3] but the package is fixed to 3.7.2 (lock file version) by a partial update and that version does not match. Make sure you list it as an argument for the update command.

Use the option --with-all-dependencies (-W) to allow upgrades, downgrades and removals for packages currently locked to specific versions.

Signed-off-by: tux-rampage <[email protected]>

renovate · 2024-11-20T11:58:16Z

Edited/Blocked Notification

Renovate will not automatically rebase this PR, because it does not recognize the last commit author and assumes somebody else may have edited the PR.

You can manually request rebase by checking the rebase/retry box above.

⚠️ Warning: custom changes will be lost.

Ocramius · 2024-11-20T12:54:39Z

src/Container/ServiceManager/AutowireFactory.php

     */
-    public function canCreate(ContainerInterface $container, $requestedName)
+    public function canCreate(ContainerInterface $container, $requestedName): bool


This class is not final, so adding these types is a BC break 🤔

Right, in this case, laminas-service-manager 4.0 cannot be supported without a major release.

In fact we have to add a conflict to laminas-service-manager >= 4.0 for the 3.x branches, since this class is not interface compatible with that version.

Another question: Is this even done correctly by editing this branch or should the renovate Issues rather be addressed with a separate PR?

I think we can open a new major version here: just needs to be against 4.0.x

Already changed the milestone here. I have some suggestions for 4.0.x in #95 to be addressed with the TSC.
This component needs some cleanup 😬

renovate bot added the renovate label Mar 4, 2024

renovate bot force-pushed the renovate/major-laminas branch from 9549ec7 to 9b3e53f Compare May 2, 2024 12:57

renovate bot changed the base branch from 3.14.x to 3.15.x May 2, 2024 13:01

renovate bot force-pushed the renovate/major-laminas branch from 9b3e53f to 2a3f5ff Compare October 12, 2024 01:38

renovate bot changed the title ~~Update dependency laminas/laminas-servicemanager to v4~~ Update Laminas packages (major) Oct 12, 2024

Fix dependency and class incompatibilities

d4c6245

Signed-off-by: tux-rampage <[email protected]>

tux-rampage self-assigned this Nov 20, 2024

tux-rampage added the Dependencies Updates and changes to dependencies label Nov 20, 2024

tux-rampage added this to the 3.15.0 milestone Nov 20, 2024

tux-rampage requested a review from Ocramius November 20, 2024 11:58

Ocramius reviewed Nov 20, 2024

View reviewed changes

tux-rampage added the BC Break label Nov 20, 2024

tux-rampage modified the milestones: 3.15.0, 4.0.0 Nov 20, 2024

tux-rampage mentioned this pull request Nov 20, 2024

Add composer conflict with incompatible service-manager release #96

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Update Laminas packages (major) #92

Update Laminas packages (major) #92

renovate bot commented Mar 4, 2024 •

edited

Loading

renovate bot commented Oct 12, 2024

renovate bot commented Nov 20, 2024

Ocramius Nov 20, 2024

tux-rampage Nov 20, 2024

Ocramius Nov 20, 2024

tux-rampage Nov 20, 2024

Update Laminas packages (major) #92

Are you sure you want to change the base?

Update Laminas packages (major) #92

Conversation

renovate bot commented Mar 4, 2024 • edited Loading

Release Notes

Release Notes for 3.0.1

3.0.1

Documentation,Enhancement

Release Notes for 3.0.0

3.0.0

renovate

Enhancement

BC Break,renovate

Release Notes for 4.3.0

4.3.0

Enhancement

Documentation,Enhancement

renovate

Release Notes for 4.2.1

4.2.1

Documentation,Enhancement

Release Notes for 4.2.0

4.2.0

Enhancement

Release Notes for 4.1.0

4.1.0

Documentation

Documentation,Enhancement

Release Notes for 4.0.2

4.0.2

Bug,Documentation

Release Notes for 4.0.1

4.0.1

Bug,Documentation

Release Notes for 4.0.0

Release Notes for 4.0.0

Added

Removed

Breaking Changes

4.0.0

Enhancement

BC Break,Enhancement

RFC

BC Break

renovate

Bug

Release Notes for 3.23.0

3.23.0

Enhancement

Release Notes for 3.22.1

3.22.1

Enhancement

Configuration

renovate bot commented Oct 12, 2024

⚠️ Artifact update problem

File name: composer.lock

renovate bot commented Nov 20, 2024

Edited/Blocked Notification

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

renovate bot commented Mar 4, 2024 •

edited

Loading