Releases · laminas/laminas-servicemanager

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

Contributors

Slamdunk, GeeH, and 3 other contributors

Assets 2

03 Mar 00:02

boesing

4.0.0-rc3

d69bfef

4.0.0-rc3 Pre-release

Pre-release

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

Contributors

boesing

Assets 2

24 Oct 11:20

laminas-bot

3.22.1

de98d29

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

Contributors

rieschl

Assets 2

10 Oct 21:32

laminas-bot

3.22.0

b4f5470

3.22.0

Release Notes for 3.22.0

3.22.0

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

Enhancement

207: Add support for PHP 8.3 thanks to @glo71317

Contributors

glo71317

Assets 2

02 Jul 14:49

boesing

4.0.0-rc2

52c22eb

4.0.0-rc2 Pre-release

Pre-release

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-rc2

Contributors

boesing

Assets 2

14 May 12:12

boesing

4.0.0-rc1

ca24d9e

4.0.0-rc1 Pre-release

Pre-release

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.20.0...4.0.0-rc1

Contributors

boesing

Assets 2

Releases: laminas/laminas-servicemanager

4.2.0

Release Notes for 4.2.0

4.2.0

Enhancement

Contributors

4.1.0

Release Notes for 4.1.0

4.1.0

Documentation

Documentation,Enhancement

Contributors

4.0.2

Release Notes for 4.0.2

4.0.2

Bug,Documentation

Contributors

4.0.1

Release Notes for 4.0.1

4.0.1

Bug,Documentation

Contributors

4.0.0

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

Contributors

4.0.0-rc3

Added

Removed

Breaking Changes

What's Changed

Contributors

3.22.1

Release Notes for 3.22.1

3.22.1

Enhancement

Contributors

3.22.0

Release Notes for 3.22.0

3.22.0

Enhancement

Contributors

4.0.0-rc2

Added

Removed

Breaking Changes

What's Changed

Contributors

4.0.0-rc1

Added

Removed

Breaking Changes

What's Changed

Contributors