webdevcave / yadic
Yet another dependency injection container for PHP
v1.2
2024-07-06 02:20 UTC
Requires
- php: >=8.1
- psr/container: ^2.0
- psr/simple-cache: ^3.0
- webdevcave/directory-crawler: ^1.1
- webdevcave/simple-cache: ^1.0
Requires (Dev)
- phpunit/phpunit: ^10
- rregeer/phpunit-coverage-check: ^0.3.1
Provides
README
This is a simple to use, yet powerful service container that provides a seamless way to automate dependency injection featuring auto-wiring and object hydration.
composer require webdevcave/yadic
Alternatively, you can clone the repository or download the source files directly and include them in your project.
Usage
Autowiring
<?php require_once __DIR__.'/vendor/autoload.php'; use Webdevcave\Yadic\Annotations\Provides; use Webdevcave\Yadic\Annotations\Singleton; use Webdevcave\Yadic\ServiceContainer; interface StorageInterface { public function store(mixed $data): bool; } #[Provides('storage')] #[Provides(StorageInterface::class)] #[Singleton] class Storage implements StorageInterface { public function store(mixed $data): bool { //store data... return true; } } class MyController { public function __construct( private StorageInterface $storage ) { } public function save(): bool { return $this->storage->store('my data...'); } } $container = new ServiceContainer(); //No need to do this in a real world application: $container->addAlias(StorageInterface::class, Storage::class); //Use this instead: //$container->loadDefinitionsFromDirectory($directory, $namespace); //Loads annotations from classes declared in a PSR4 directory //var_dump($container->get('storage')->store($data)); var_dump($container->get(MyController::class)->save()); //bool(true)
Invoking a method ft. autowiring
$arguments = ['nonInjectableArgument' => 'value']; //optional $container->invoke([$instance, 'methodName'], $arguments);
Hydration
//Class declarations: use Webdevcave\Yadic\Annotations\ArrayOf; class Candidate { public function __construct( public ?string $name = null, public ?int $age = null, #[ArrayOf(Skill::class)] public array $skills = [] ) { } } class Skill { public function __construct( public string $title, ) { } } // Hydration example 1: $data = [ 'name' => 'John Doe', 'age' => 25, 'skills' => [ ['title' => 'PHP'], ['title' => 'Java'], ['title' => 'Rust'], ['title' => 'React'], ], ]; $instance = $container->hydrate(Candidate::class, $data); //Results output /* print_r($instance); This test printed output: Candidate Object ( [name] => John Doe [age] => 25 [skills] => Array ( [0] => Skill Object ( [title] => PHP ) [1] => Skill Object ( [title] => Java ) [2] => Skill Object ( [title] => Rust ) [3] => Skill Object ( [title] => React ) ) ) */ // Hydration example 2: $data = [ [ 'name' => 'Foo', //... ], [ 'name' => 'Bar', //... ] ]; $instances = $container->hydrate(Candidate::class, $data); //Results output /* print_r($instances); This test printed output: Array ( [0] => Candidate Object ( [name] => Foo //... ) [1] => Candidate Object ( [name] => Bar //... ) ) */
Contributing
Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or a pull request on GitHub.
License
This project is licensed under the MIT License - see the LICENSE file for details.