4.3.0

Release Notes for 4.3.0

Feature release (minor)

Introduces PHP 8.4 Support

4.3.0

• Total issues resolved: 0
• Total pull requests resolved: 5
• Total contributors: 4

Enhancement

• 248: Update to use PHPUnit 10 syntax thanks to @samsonasik
• 247: Update to latest PHP 8.1 syntax thanks to @samsonasik
• 246: Merge release 3.23.0 into 4.3.x thanks to @github-actions[bot]

Documentation,Enhancement

• 245: Merge release 4.2.1 into 4.3.x thanks to @gsteel

renovate

• 241: Update dependency laminas/laminas-coding-standard to v3 thanks to @renovate[bot]

3.23.0

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

4.2.1

Release Notes for 4.2.1

4.2.x bugfix release (patch)

4.2.1

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

Documentation,Enhancement

• 244: Add mixed as array shape thanks to @grizzm0

4.2.0

Release Notes for 4.2.0

Feature release (minor)

4.2.0

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

Enhancement

• 237: Allow varexporter v0.5 thanks to @snapshotpl

4.1.0

Release Notes for 4.1.0

Feature release (minor)

4.1.0

• Total issues resolved: 1
• Total pull requests resolved: 3
• Total contributors: 2

Documentation

• 234: Merge release 4.0.2 into 4.1.x thanks to @github-actions[bot]
• 232: Merge release 4.0.1 into 4.1.x thanks to @github-actions[bot]

Documentation,Enhancement

• 230: Make ServiceLocatorInterface#get() generic thanks to @InvisibleSmiley

4.0.2

Release Notes for 4.0.2

4.0.x bugfix release (patch)

4.0.2

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

Bug,Documentation

• 233: Update docs-build workflow triggers and environment variables thanks to @froschdesign

4.0.1

Release Notes for 4.0.1

4.0.x bugfix release (patch)

4.0.1

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

Bug,Documentation

• 226: Fixes documentation to support different versions thanks to @froschdesign

4.0.0

Release Notes for 4.0.0

Release Notes for 4.0.0

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

• 182: Remove AbstractPluginManager#validate thanks to @boesing
• 174: Mark ServiceManager as final and change AbstractPluginManager to use composition over inheritance thanks to @boesing

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

4.0.0-rc3

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

---

What's Changed

• Remove container-interop/container-interop polyfill by @boesing in #169
• Remove deprecated factories by @boesing in #170
• Remove deprecated ServiceManager#getServiceLocator method by @boesing in #181
• Convert old CLI standalone commands to laminas-cli commands by @boesing in #176
• Ahead of time factory creation command by @boesing in #180
• Remove removed binaries from composer by @boesing in #187
• Remove ServiceManager inheritance for AbstractPluginManager by @boesing in #179
• Add support for psr/container v2 by @boesing in #188
• Modernize codebase by @boesing in #191
• Narrow return type of single instance plugin managers by @boesing in #194

Full Changelog: 3.21.0...4.0.0-rc3

3.22.1

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