Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chubbyphp/chubbyphp-container
A minimal Dependency Injection Container (DIC) which implements PSR-11.
https://github.com/chubbyphp/chubbyphp-container
chubbyphp-container container psr-11 servicefactory
Last synced: 15 days ago
JSON representation
A minimal Dependency Injection Container (DIC) which implements PSR-11.
- Host: GitHub
- URL: https://github.com/chubbyphp/chubbyphp-container
- Owner: chubbyphp
- License: mit
- Created: 2019-11-22T21:05:46.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-10T20:00:23.000Z (5 months ago)
- Last Synced: 2024-12-10T22:31:37.373Z (24 days ago)
- Topics: chubbyphp-container, container, psr-11, servicefactory
- Language: PHP
- Homepage:
- Size: 50.8 KB
- Stars: 14
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# chubbyphp-container
[](https://github.com/chubbyphp/chubbyphp-container/actions/workflows/ci.yml)
[](https://coveralls.io/github/chubbyphp/chubbyphp-container?branch=master)
[](https://dashboard.stryker-mutator.io/reports/github.com/chubbyphp/chubbyphp-container/master)
[](https://packagist.org/packages/chubbyphp/chubbyphp-container)
[](https://packagist.org/packages/chubbyphp/chubbyphp-container)
[](https://packagist.org/packages/chubbyphp/chubbyphp-container)
[](https://sonarcloud.io/dashboard?id=chubbyphp_chubbyphp-container)
[](https://sonarcloud.io/dashboard?id=chubbyphp_chubbyphp-container)
[](https://sonarcloud.io/dashboard?id=chubbyphp_chubbyphp-container)
[](https://sonarcloud.io/dashboard?id=chubbyphp_chubbyphp-container)
[](https://sonarcloud.io/dashboard?id=chubbyphp_chubbyphp-container)
[](https://sonarcloud.io/dashboard?id=chubbyphp_chubbyphp-container)
[](https://sonarcloud.io/dashboard?id=chubbyphp_chubbyphp-container)
[](https://sonarcloud.io/dashboard?id=chubbyphp_chubbyphp-container)
[](https://sonarcloud.io/dashboard?id=chubbyphp_chubbyphp-container)
[](https://sonarcloud.io/dashboard?id=chubbyphp_chubbyphp-container)
[](https://sonarcloud.io/dashboard?id=chubbyphp_chubbyphp-container)
## Description
A minimal Dependency Injection Container (DIC) which implements PSR-11. [DI Container Benchmark][3].
There is a laminas service manager adapter at [chubbyphp/chubbyphp-laminas-config][4].
## Requirements
* php: ^8.2
* [psr/container][2]: ^2.0.2
## Installation
Through [Composer](http://getcomposer.org) as [chubbyphp/chubbyphp-container][1].
```sh
composer require chubbyphp/chubbyphp-container "^2.3"
```
## Usage
There are two PSR-11 implementations:
* `Chubbyphp\Container\Container` prototype (each get will return a new instance) and shared services
* `Chubbyphp\Container\MinimalContainer` shared services
### MinimalContainer / Container
#### Factories
```php
factories([
MyService::class => static function (ContainerInterface $container): MyService {
return new MyService($container->get(LoggerInterface::class));
},
]);
```
#### Factory
```php
factory(MyService::class, static function (ContainerInterface $container): MyService {
return new MyService($container->get(LoggerInterface::class));
});
// existing (replace)
$container->factory(MyService::class, static function (ContainerInterface $container): MyService {
return new MyService($container->get(LoggerInterface::class));
});
// existing (extend)
$container->factory(
MyService::class,
static function (ContainerInterface $container, callable $previous): MyService {
$myService = $previous($container);
$myService->setLogger($container->get(LoggerInterface::class));
return $myService;
}
);
```
#### Factory with Parameter
```php
factory('key', new Parameter('value'));
```
#### Get
```php
get(MyService::class);
```
#### Has
```php
has(MyService::class);
```
### Container
All methods of the `MinimalContainer` and the following:
#### Prototype Factories
**each get will return a new instance**
```php
prototypeFactories([
MyService::class => static function (ContainerInterface $container): MyService {
return new MyService($container->get(LoggerInterface::class));
},
]);
```
#### Prototype Factory
**each get will return a new instance**
```php
prototypeFactory(
MyService::class,
static function (ContainerInterface $container): MyService {
return new MyService($container->get(LoggerInterface::class));
}
);
// existing (replace)
$container->prototypeFactory(
MyService::class,
static function (ContainerInterface $container): MyService {
return new MyService($container->get(LoggerInterface::class));
}
);
// existing (extend)
$container->prototypeFactory(
MyService::class,
static function (ContainerInterface $container, callable $previous): MyService {
$myService = $previous($container);
$myService->setLogger($container->get(LoggerInterface::class));
return $myService;
}
);
```
## Migration
* [From Pimple][5]
## Copyright
2024 Dominik Zogg
[1]: https://packagist.org/packages/chubbyphp/chubbyphp-container
[2]: https://packagist.org/packages/psr/container
[3]: https://kocsismate.github.io/php-di-container-benchmarks/benchmark.html
[4]: https://github.com/chubbyphp/chubbyphp-laminas-config
[5]: doc/MigrateFromPimple.md