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
andServiceLocatorInterface#build
now explicitly implementmixed
as return-type to synchronize types withContainerInterface#get
- Support for
psr/container
v1.1 and v2.0 - Ahead of Time factory creation for services explicitly using
ReflectionBasedAbstractFactory
vialaminas-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 thelaminas-cli
integration. All CLI commands of v3.x are accessible viavendor/bin/laminas servicemanager:<v3.x command name>
oncelaminas/laminas-cli
is required in the projects dependencies - Removed deprecated
ConfigInterface
andConfig
-class since these files did not provide any validation logic and were just used to proxy the configuration array structure - Removed
AbstractPluginManager#validate
andAbstractPluginManager::$instanceOf
property as in v3.x, implementing plugin managers were able to implicitlyvalidate
mixed
. In case an implementing plugin manager is providing a single$instanceOf
such aslaminas-cache
, there is a new classAbstractSingleInstancePluginManager
available which requires the$instanceOf
property to be configured
Breaking Changes
AbstractPluginManager
does not extendServiceManager
anymore and instead uses an ownServiceManager
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 vialaminas-cli
and can be called viavendor/bin/laminas
oncelaminas/laminas-cli
is part of the projects requirements. Read more about how to consume these commands here. AbstractPluginManager
does not provide thevalidate
-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 nativestring
property type) - implement
validate
method and verify whatever type has to be returned and/or just allowmixed
as v3.x did when omitting$instanceOf
property
- extend
- Removed deprecated
ConfigInterface
andConfig
-class since these files did not provide any validation logic and were just used to proxy the configuration array structure - neither
ServiceManager
norAbstractPluginManager
do validate the provided configuration at runtime anymore. due to the psalm-types provided toServiceManager#__construct
,ServiceManager#configure
,AbstractPluginManager#__construct
andAbstractPluginManager#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 forAbstractPluginManager
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