DI Cheat Sheet

DI Cheat Sheet#

Quick reference for the current InterMix DI API.

Container Entry Points#

Action	API
Create/get instance	`container()` / `Container::instance('app')` / `resolve(null, [], 'app')`
Get manager	`$c->definitions()` / `$c->registration()` / `$c->options()` / `$c->invocation()`
Resolve by ID/class	`$c->get($id)`
Resolve + execute default/registered method	`$c->getReturn(Foo::class)`
Build class (optional method)	`$c->make(Foo::class, false\|'run')`
Call closure/function/class/method	`$c->call($target, $method)`
Scopes	`$c->enterScope('req-1')` / `$c->leaveScope()` / `$c->withinScope('req-1', fn () => ...)`
Tags / tracing / graph	`$c->findByTag('event')`, `$c->debug($id)`, `$c->tracer()->toArray()`, `$c->exportGraph()`
Freeze config	`$c->lock()`

Managers At A Glance#

Manager	Core methods
`definitions()`	`bind()`, `addDefinitions()`, `enableDefinitionCache($pool)`, `cacheAllDefinitions()`, `setMetaForEnv()`
`registration()`	`registerClass()`, `registerMethod()`, `registerProperty()`, `registerClosure()`, `import()`
`options()`	`setOptions()`, `enableLazyLoading()`, `setEnvironment()`, `bindInterfaceForEnv()`, `setDefinitionMetaForEnv()`, `enableDebugTracing()`, `registerAttributeResolver()`, `generatePreload()`
`invocation()`	`call()`, `make()`, `get()`, `getReturn()`, `has()`

All managers use ManagerProxy: $mgr('id'), $mgr->id, $mgr['id'], proxied container methods and ->end() to return to the container.

Task Matrix (Fluent vs Shortcut)#

Task	Fluent chain	Shortcut on container
Bind definition	`$c->definitions()->bind('answer', 42)`
Register constructor map	`$c->registration()->registerClass(Foo::class)`
Set options	`$c->options()->setOptions(...)`	`$c->enableLazyLoading(true)`
Resolve service	`$c->invocation()->get(Foo::class)`	`$c->get(Foo::class)`
Resolve return value	`$c->invocation()->getReturn(Foo::class)`	`$c->getReturn(Foo::class)`
Call target	`$c->invocation()->call($target)`	`$c->call($target)`
Build target	`$c->invocation()->make(Foo::class)`	`$c->make(Foo::class)`

Common Recipes#

Bootstrap chain:

$c->definitions()
    ->bind(LoggerInterface::class, FileLogger::class)
    ->registration()
    ->registerClass(App::class, ['name' => 'InterMix'])
    ->options()
    ->setOptions(injection: true, methodAttributes: true)
    ->enableLazyLoading(true)
    ->end();

Environment-specific binding + metadata:

use Infocyph\InterMix\DI\Support\LifetimeEnum;

$c->options()
    ->bindInterfaceForEnv('prod', MailerInterface::class, SmtpMailer::class)
    ->bindInterfaceForEnv('test', MailerInterface::class, FakeMailer::class)
    ->setDefinitionMetaForEnv('test', 'mailer', LifetimeEnum::Transient, ['core', 'test-only'])
    ->setEnvironment('test');

Definition cache warmup:

$c->definitions()
    ->enableDefinitionCache($pool)
    ->cacheAllDefinitions(forceClearFirst: true);

Scoped resolution:

$result = $c->withinScope('request-42', function () use ($c) {
    return $c->get(RequestContext::class);
});

Advanced Helpers#

$c->parseCallable($spec): normalize closure/function/class/method input (class-method targets must be autoloadable and exist).
$c->resolveNow(...): resolve with explicit runtime knobs.
$c->getRepository(): inspect low-level runtime state.
$c->setResolverClass(FooResolver::class): swap resolver implementation.