HH-Container
simple light weight service location / dependency injection container
Installation
$ hhvm $(which composer) require ytake/hh-container"require": {
"hhvm": ">=3.24",
"ytake/hh-container": "^1.0"
},Usage
$container = new \Ytake\HHContainer\FactoryContainer();
$container->set('testing', $container ==> 'testing');
$container->get('testing'); // return stringSingleton or Prototype
default prototype
SINGLETON
$container = new \Ytake\HHContainer\FactoryContainer();
$container->set('scope:singleton', $container ==> new \stdClass(), \Ytake\HHContainer\Scope::Singleton);PROTOTYPE
$container = new \Ytake\HHContainer\FactoryContainer();
$container->set('scope:prototype', $container ==> new \stdClass(), \Ytake\HHContainer\Scope::Prototype);Dependency Injection
set parameters
sample class
final class MessageClass {
public function __construct(
protected string $message
) {}
public function message(): string {
return $this->message;
}
}
final class MessageClient {
public function __construct(
protected MessageClass $message
) {}
public function message(): MessageClass {
return $this->message;
}
}Inject
$container = new \Ytake\HHContainer\FactoryContainer();
$container->set('message.class', $container ==> new MessageClass('testing'));
$container->set(MessageClient::class, $container ==> {
$instance = $container->get('message.class');
invariant($instance instanceof MockMessageClass, 'error');
new MessageClient($instance);
});
$instance = $container->get(MessageClient::class);callable
returns the value of a callable with parameters supplied at calltime.
final class TestingInvokable {
public function __invoke(FactoryContainer $container): int {
return 1;
}
}
$container = new \Ytake\HHContainer\FactoryContainer();
$container->set(TestingInvokable::class, $container ==>
$container->callable(
new \Ytake\HHContainer\Invokable(
new TestingInvokable(), '__invoke', $container
)
)
);
Use modules
use Ytake\HHContainer\ServiceModule;
use Ytake\HHContainer\FactoryContainer;
class ExampleModule extends ServiceModule {
public function provide(FactoryContainer $container): void {
$container->set('example', $container ==> new \stdClass());
}
}
$container = new \Ytake\HHContainer\FactoryContainer();
$container->register(ExampleModule::class);
$container->lockModule();Service Factory
use Ytake\HHContainer\Scope;
use Ytake\HHContainer\ServiceFactory;
use Ytake\HHContainer\FactoryContainer;
use Ytake\HHContainer\FactoryInterface;
class StringFactory implements FactoryInterface {
const type T = string;
public function provide(FactoryContainer $_container): StringFactory::T {
return 'testing';
}
public function scope(): Scope {
return Scope::Singleton;
}
public function name(): string {
return 'testing'
}
}
$factory = new ServiceFactory(new FactoryContainer());
$factory->registerFactory(new StringFactory());
$factory->create('testing');
