Container Laravel Package

Added

• Event system for hooking into the container lifecycle
  • Four event types: OnDefineEvent, BeforeResolveEvent, DefinitionResolvedEvent, ServiceResolvedEvent
  • Fluent filtering API: forType(), forTag(), forId(), where()
  • Container::listen() for registering filtered event listeners
  • Container::afterResolve() convenience method as a drop-in replacement for inflector()
  • Lazy event dispatch: events are only created when listeners are registered for that event type
  • EventDispatcher::hasListenersFor() to check whether listeners exist for a given event type
  • DefinitionInterface::getTags() for retrieving tags from definitions
  • Docs: https://container.thephpleague.com/5.x/events/
• Container::getDelegate(string $class) to retrieve a registered delegate container by type

Fixed

• Interface-to-concrete definitions now correctly resolve through the concrete's own registered definition instead of bypassing it via direct reflection (#275, #278)
• Definition::resolveClass() now throws ContainerException with actionable guidance when a class has unsatisfied constructor dependencies, instead of a raw ArgumentCountError

Deprecated

• Container::inflector() - use Container::afterResolve() or the event system instead. Will be removed in v6.0.

Changed

• DefinitionContainerInterface no longer extends EventAwareContainerInterface (removed)
• Shared definitions now receive a 'shared' tag automatically via addTag('shared')

Removed

• EventAwareContainerInterface - the event system is provided by EventAwareTrait on the concrete Container class, not as an interface contract

Added

• Attribute based resolution for dependencies using #[Inject] and #[Resolve] attributes.
  • Docs: https://container.thephpleague.com/5.x/attribute-resolution/
• Support for PHPUnit 12 (@ADmad)
• Explicit non-support for auto-wiring union types.

Changed

• Small internal changes for stricter static analysis and type safety. (@ADmad)

5.0.1

Fixed

• Fixed a small unreachable code bug

Fixed

• Now properly handle string based fully qualified class names in with preceding slashes. (@M1ke)

Fixed

• Warnings for PHP 8.4 implicit nullable types (@andypost)

Fixed

• Remove an unnecessary conditional in ServiceProviderAggregate. (@SubhanSh)
• Fixed an infinite loop in resolving definitions. (@arai-ta)

Added

• Support for psr/container 1.1.0.

Fixed

• Fix bug that was causing an error on inflection due to introduced type hint.

Changed

• Move files autoload directive to dev (@ADmad)

Added

• Way to handle non-public controllers safely (@beryllium)

Added

• New definition interface that extends psr/container
• Literal and resolvable argument wrappers for better explicitness in definitions

Changed

• PHP requirement now >=7.2
• Updated psr/container to ^2.0.0
• Container::shared convenience method is now explicit Container::addShared method
• Removed third argument $shared from Container::add, use Container::addShared
• ServiceProviderInterface now defines return types
• Service providers now require implementation of a provides method rather than relying on a class property.

Added

• Way to handle non-public controllers safely (@beryllium)
• PHPUnit ^7.0 for PHP versions that support it (@beryllium)

Removed

• Support for psr/container ^2.0.0 as the interface cannot be reconciled between versions

Fixed

• Fixed an issue that caused a recursive register call. @pcoutinho
• Fixed a return type declaration. @orbex

Fixed

• Fixed bug relating to ReflectionContainer::call on arrow functions.

Added

• Experimental support for PHP 8.

Fixed

• Fix issue when preventing reflection from using default value for arguments.

Fixed

• Respect $new argument when getting tagged definitions.

Added

• Support for PHP 7.3
• {set,get}LeagueContainer methods added to ContainerAwareTrait as a temporary measure until next major release when this can be properly addressed, less hinting of Psr\Container\ContainerInterface

Changed

• Various internal code improvements

Fixed

• Fix for setConcrete not re-resolving class on when overriding (@jleeothon)
• Fix stack overflow error incase a service provider lies about providing a specific service (@azjezz)
• Fix issue where providers may be aggregated multiple times (@bwg)
• Various documentation fixes

Fixed

• Fixed issue that prevented service providers from registering if a previous one in the aggregate was already registered.

Fixed

• Fixed issue where all service providers were registered regardless of whether they need to be.

Added

• Added ability to add definition as not shared when container is set to default to shared.
• Added {set|get}Concrete to definitions to allow for better use of extend.

Added

• Re-added the share proxy method that was mistakenly removed in previous major release.
• Added ability to set Container to "share" by default using defaultToShared method.
• Added ability for ReflectionContainer to cache resolutions and pull from cache for following calls.

Added

• Allow definition aggregates to be built outside of container.

Added

• Service providers can now be pulled from the container if they are registered.
• Definition logic now handled by aggregate for better separation.
• Now able to add tags to a definition to return an array of items containing that tag.

Changed

• Updated minimum PHP requirements to 7.0.
• Now depend directly on PSR-11 interfaces, including providing PSR-11 exceptions.
• Refactored inflector logic to accept type on construction and use generator to iterate.
• Refactored service provider logic with better separation and performance.
• Merged service provider signature logic in to one interface and abstract.
• Heavily simplified definition logic providing more control to user.

Fixed

• Ensures ReflectionContainer converts class name in array callable to object.

Changed

• Can now wrap shared objects as RawArgument.
• Ability to override shared items.

Fixed

• Booleans now recognised as accepted values.
• Various docblock fixes.
• Unused imports removed.
• Unreachable arguments no longer passed.

Added

• Now implementation of the PSR-11.

Changed

• Service providers can now be added multiple times by giving them a signature.

Added

• Allow resolving of RawArgument objects as first class dependencies.

Changed

• Unnecessary recursion removed from Container::get.

Fixed

• Bug where delegating container was not passed to delegate when needed.
• Bug where Container::extend would not return a shared definition to extend.

Fixed

• Bug introduced in 2.0.1 where shared definitions registered via a service provider would never be returned as shared.

Fixed

• Fixed bug where arbitrary values were attempted to be resolved as classes.

Added

• Added ServiceProvider functionality to allow cleaner resolving of complex dependencies.
• Added Inflector functionality to allow for manipulation of resolved objects of a specific type.
• Improvements to DRY throughout the package.

Fixed

• Setter in ContainerAwareTrait now returns self ($this).

Fixed

• Allow arbitrary values to be registered via container config.

Added

• Improvements to Container::call functionality.

Fixed

• General code tidy.
• Improvements to test suite.

Fixed

• Allow singleton to be passed as method argument.

Added

• Addition of ContainerAwareTrait to provide functionality from ContainerAwareInterface.

Added

• Migrated from Orno\Di.

Added

• Ability to overwrite a definition within the container, disabled by default

Changed

• PHP requirement now >=8.1
• General language modernisation
• General prep for future updates and container compilation

Added

• Support for psr/container ^2.0.0

Fixed

• Bug where shared definitions were not stored as shared.

Added

• Now implementation of the container-interop project.
• BootableServiceProviderInterface for eagerly loaded service providers.
• Delegate container functionality.
• RawArgument to ensure scalars are not resolved from the container but seen as an argument.

Altered

• Refactor of definition functionality.
• Container::share replaces singleton functionality to improve understanding.
• Auto wiring is now disabled by default.
• Auto wiring abstracted to be a delegate container ReflectionContainer handling all reflection based functionality.
• Inflection functionality abstracted to an aggregate.
• Service provider functionality abstracted to an aggregate.
• Much bloat removed.
• Container::call now proxies to ReflectionContainer::call and handles argument resolution in a much more efficient way.

Removed

• Ability to register invokables, this functionality added a layer of complexity too large for the problem it solved.
• Container no longer accepts a configuration array, this functionality will now be provided by an external service provider package.

Added

• Added isRegisteredCallable method to public API.
• Invoking call now accepts named arguments at runtime.

Fixed

• Container now stores instantiated Service Providers after first instantiation.
• Extending a definition now looks in Service Providers as well as just Definitions.