Download the PHP package jshannon63/cobalt without Composer
On this page you can find all versions of the php package jshannon63/cobalt. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download jshannon63/cobalt
More information about jshannon63/cobalt
Files in jshannon63/cobalt
Package cobalt
Short Description A fast, autowired PSR-11 dependency injection container for PHP with cached resolution closures.
License MIT
Homepage https://github.com/jshannon63/cobalt
Informations about the package cobalt
Cobalt — An Autowired Dependency Injection Container for PHP
Realized in fewer than 200 lines of source.
Well documented, perfect for building/learning.
100% line and method coverage on PHP 8.2, 8.3, and 8.4.
One of the fastest PHP dynamic autowired containers available.
Cobalt was created to push the performance limits of what a PHP-based dynamic
autowired DI container can achieve. Container::class implements the PSR-11
ContainerInterface and provides many of the features found in more notable
container projects. Resolution closures are cached after the first build, so
subsequent lookups skip all reflection work. Cobalt and its simple, heavily
commented source are perfect for learning, or for embedding inside projects
and frameworks.
The Cobalt service container has the following features:
- Single class container implementing the PSR-11
ContainerInterfacev2. ArrayAccessmethods for container bindings.- Constructor injection of type-hinted dependencies.
- Dependency injection through
bind()method closures. - Autowired dependency resolution using Reflection.
- Top-down inversion of control (IoC).
- Shared mode option (singleton only).
- Bind existing instances into the container.
- A self-binding global container instance.
Installation
Usage
Creating the container
Binding into the container
Binding does not instantiate the class. Instantiation is deferred until the
binding is requested from the container. bind() accepts three parameters:
the abstract name, the concrete implementation, and a boolean for whether
the binding is a singleton. The abstract name is free-form and acts as the
key in the binding registry.
bind(string $abstract, mixed $concrete = null, bool $singleton = false): void
Resolving out of the container
$instance = resolve(string $id): mixed (resolve checks for an existing binding before instantiating)
Trying to resolve a missing binding throws NotFoundException per PSR-11.
Using the make() method
make() is bind() then resolve() — useful for one-shot instantiation.
$instance = make(string $abstract, mixed ...$args): mixed
Creating an alias to a binding
alias(string $alias, string $binding): void
Allows creating additional string IDs for accessing existing container bindings.
Binding an existing instance
Pass an object to bind() and Cobalt registers it as a singleton automatically
(a pre-built instance is by definition shared).
Checking if a binding exists
$bool = has(string $abstract): bool
Getting the values of a single binding
$array = getBinding(string $abstract): array
Getting a list of bindings
$array = getBindings(): array
Development
Run the full quality bar locally:
Or individually:
License
The MIT License (MIT). Please see License File for more information.