Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/quillstack/di
The dependency injection container, based on PSR-11: Container interface.
https://github.com/quillstack/di
class constructor container dependency-injection di di-container php8 properties property psr-11 quillstack
Last synced: about 2 months ago
JSON representation
The dependency injection container, based on PSR-11: Container interface.
- Host: GitHub
- URL: https://github.com/quillstack/di
- Owner: quillstack
- License: mit
- Created: 2020-08-30T12:20:04.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2022-06-02T11:34:09.000Z (over 2 years ago)
- Last Synced: 2024-11-13T10:53:51.845Z (about 2 months ago)
- Topics: class, constructor, container, dependency-injection, di, di-container, php8, properties, property, psr-11, quillstack
- Language: PHP
- Homepage: https://quillstack.org/di
- Size: 53.7 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Quillstack DI Container
[](https://app.travis-ci.com/quillstack/di)
[](https://packagist.org/packages/quillstack/di)
[](https://sonarcloud.io/dashboard?id=quillstack_di)
[](https://sonarcloud.io/dashboard?id=quillstack_di)
[](https://github.styleci.io/repos/291464853?branch=main)
[](https://www.codefactor.io/repository/github/quillstack/di)
[](https://sonarcloud.io/dashboard?id=quillstack_di)
[](https://codeclimate.com/github/quillstack/di/maintainability)
[](https://sonarcloud.io/dashboard?id=quillstack_di)
Quillstack DI Container is the dependency injection container based
on _PSR-11: Container interface_, and with the main goal: to be fast.
You can find the full documentation on the website: \
https://quillstack.org/di
This DI container uses constructors and types of class properties.
### Installation
To install this package, run the standard command using _Composer_:
```
composer require quillstack/di
```
### Usage
You can use Quillstack DI Container when you want:
- To have a simple and fast DI container.
- Define dependencies based on interfaces.
- Define parameters e.g. credentials for a database in the `Database` class.
- To use constructors or/and class properties.
- To implement your own instance factories e.g. for `Request` classes.
- To use objects as dependencies.
#### Simple usage
You can easily start using a DI Container:
```php
get(ExampleController::class);
```
Where your `ExampleController` class looks like:
```php
Logger::class,
]);
$controller = $container->get(ExampleController::class);
```
You can define your dependencies using interfaces:
```php
[
'hostname' => 'localhost',
],
]);
$controller = $container->get(ExampleController::class);
```
Every time you will get a database object, a container will use `localhost` as
a value for `$hostname` parameter:
```phpt
container->get(GivenRequestFromGlobalsFactory::class);
return $factory->createGivenServerRequest($id);
}
}
```
Also, use this configuration array when you create a DI container:
```php
$container = new Container([
RequestInterface::class => RequestClassFactory::class,
]);
$controller = $container->get(ExampleController::class);
```
Custom factories are useful for objects you want to create similarly.
#### Dependencies as objects
In this example, whenever a new class of LoggerInterface will be required as a dependency, a container will use a
previously defined object. This object can be created once in a bootstrap file and used in the entire application:
```php
$logger = new Logger('name');
$logger->pushHandler(new StreamHandler('var/app.log'););
$container = new Container([
LoggerInterface::class => $logger,
]);
```
This configuration is helpful if an object should be created once and its instance
should be used in other places in the application.
### Unit tests
Run tests using a command:
```
phpdbg -qrr ./vendor/bin/unit-tests
```
### Docker
```shell
$ docker-compose up -d
$ docker exec -w /var/www/html -it quillstack_di sh
```