koriym / dii
Dependency Injection Plugin for Yii 1
Installs: 24 859
Dependents: 0
Suggesters: 0
Security: 0
Stars: 17
Watchers: 7
Forks: 3
Open Issues: 1
Requires
- php: ^7.1 || ^8.0
- ray/di: ^2.10
- yiisoft/yii: ^1.1.16
Requires (Dev)
- doctrine/coding-standard: ^8.2
- phpmd/phpmd: ^2.9
- phpunit/phpunit: ^8.5 || ^9.6.19
- squizlabs/php_codesniffer: ^3.5
- symfony/process: ^5.2
This package is auto-updated.
Last update: 2024-10-09 06:44:02 UTC
README
Dependency Injection Container Plugin for Yii 1
This plugin adds the ability to configure object instances and their dependencies before they are used, and to store them into a container class to easy access.
It uses the clean and flexible Ray.Di DI framework which is a PHP dependency injection framework in the style of "Google Guice".
Ray.Di also allows you to program using AOP, that is, decorating the configured instances so some logic can be run before or after any of their methods.
Configuration
Bootstrap file
Use composer autoloader instead of Yii autoloader.
// composer autoloader require dirname(__DIR__) . '/vendor/autoload.php'; spl_autoload_unregister([YiiBase::class, 'autoload']); // set context module Dii::setContext(\YourVendor\YourProject\Context\App::class); // run the application Yii::createWebApplication()->run();
Binding module
Modules are classes that describe how instances and their dependencies should be constructed, they provide a natural way of grouping configurations. An example module looks like this:
<?php namespace Koriym\Dii\Module; use Ray\Di\AbstractModule; use Vendor\Hello\BarInterceptor; use Vendor\Hello\Foo; use Vendor\Hello\FooInterface; class AppModule extends AbstractModule { protected function configure() { $this->bind(FooInterface::class)->to(Foo::class); $this->bindInterceptor( $this->matcher->any(), $this->matcher->startsWith('actionIndex'), [BarInterceptor::class] ); } }
Context
You can make the necessary bindings depending on the context. The context class specifies which module to bind in.
use Koriym\Dii\Module\AppModule; use Koriym\Dii\ModuleProvider; use Ray\Di\AbstractModule; class App implements ModuleProvider { public function __invoke() : AbstractModule { return new AppModule(); } }
In this example we have overridden the binding of AppModule
with TestModule
.
class Test implements ModuleProvider { public function __invoke() : AbstractModule { // override AppModule with TestModule return new TestModule(new AppModule()); } }
Injecting Dependencies in Controllers
Ray.Di is able to inject instances to your controllers based on annotations:
<?php use Koriym\Dii\Injectable; use Ray\Di\Di\Inject; use Vendor\Hello\FooInterface; class SiteController extends CController implements Injectable { private $foo; /** * @Inject */ public function setDeps(FooInterface $foo) { $this->foo = $foo; } public function actionIndex() { echo 'Hello World' . $this->foo->get(); } }
As soon as the controller is created, all methods having the @Inject
annotation will get instances of the hinted class passed. This works only for setter method, not constructors. Please implemet marker interface Injectable
to notify Ray.Di the class injectable.
Also any class created by Yii:createComponent()
method is worked as well.
Demo
cd demo
composer install
composer serve