InterMix

InterMix is a modern, lightweight PHP toolkit for developers who value class-oriented design, clean architecture, and fast execution. It combines dependency injection, serialization, macro-style extensibility, and helper utilities with minimal config and maximum control.

Global helper functions are optional: core APIs are namespaced and helper loading is opt-in.

Key Features

• Dependency Injection (DI) — PSR-11 compliant container with:
  • attribute-based injection
  • scoped lifetimes
  • lazy loading
  • environment-specific overrides
  • debug tracing & definition-cache integration via assignable PSR-6 pool
• Serializer — Closure-aware value serialization and resource handlers
• Fence — Enforce singleton-style class safety
• Remix — Fluent traits, proxies, and global helper functions
• MacroMix — Dynamically extend objects or classes with macros
• Global Utilities — Like pipe(), retry(), measure() and more

Installation

composer require infocyph/intermix

Optional global helpers:

require_once __DIR__ . '/vendor/infocyph/intermix/src/functions.php';

Current InterMix releases require PHP 8.4 or newer, as declared by composer.json.

Quick Examples

Dependency Injection

use function Infocyph\InterMix\container;

$c = container();
$c->definitions()->bind('now', fn () => new DateTimeImmutable());

echo $c->get('now')->format('c');

Enable autowiring with attributes:

$c->options()->setOptions(
    injection: true,
    methodAttributes: true,
    propertyAttributes: true
);

Tag-based resolution:

$c->definitions()->bind('a', A::class, tags: ['service']);
$c->definitions()->bind('b', B::class, tags: ['service']);

foreach ($c->findByTag('service') as $svc) {
    $svc->handle();
}

Reflection-free factories:

use Infocyph\InterMix\DI\Container;
use Infocyph\InterMix\DI\Support\LifetimeEnum;

$c->bindFactory(
    Database::class,
    static fn (Container $container): Database => new Database(
        $container->get(DatabaseConfig::class),
    ),
    LifetimeEnum::Singleton,
    tags: ['infrastructure'],
);

// Equivalent fluent lifetime selection:
$c->factory(
    RequestContext::class,
    static fn (Container $container): RequestContext => new RequestContext(
        $container->get('request.id'),
    ),
)->scoped();

Use a regular closure definition when its parameters should be autowired. Use bindFactory() or factory() when dependencies are explicit and request-time reflection should be avoided. Direct factories behave identically whether container injection is enabled or disabled.

See full container guide at: https://docs.infocyph.com/projects/intermix/di/overview.html

Dynamic Macros

MacroTest::mix(new class {
    public function hello($name) {
        return "Hey, $name!";
    }
});

echo (new MacroTest)->hello('Ali'); // Hey, Ali!

Definition Cache (Injectable)

use Psr\Cache\CacheItemPoolInterface;

$pool = /* any PSR-6 pool, e.g. from infocyph/cachelayer */;
$c->definitions()->enableDefinitionCache($pool, cacheRuntimeObjects: false);

Compiled Resolvers

use Infocyph\InterMix\DI\Support\FactoryDefinition;
use Infocyph\InterMix\DI\Support\ServiceReference;

$path = __DIR__ . '/var/intermix.compiled.php';

// Explicit recipes can be executed dynamically and compiled safely.
$c->bind('mailer', FactoryDefinition::construct(Mailer::class, [
    new ServiceReference(Logger::class),
    'transactional',
]));

// Build time, after every definition and option is registered.
$c->compileTo($path);
$report = $c->compilationReport();

// Runtime, after performing the same registration.
$c->useCompiled($path);

Artifacts include PHP, InterMix, environment, definition, resolution configuration, lifetime, tag, and compiled-recipe fingerprints. Incompatible artifacts fail closed. Automatic class recipes pass conservative cache-time eligibility checks; contextual, attributed, resource-configured, implicit-method, and otherwise dynamic definitions remain on the normal resolver with an exact reason in the compilation report. A later container configuration mutation disables the active map until it is rebuilt. Ordinary closures and bindFactory() definitions deliberately remain dynamic.

See the compiled resolver guide.

Signed Serialization

$signed = \Infocyph\InterMix\Serializer\ValueSerializer::signed($_ENV['APP_KEY']);
$token = $signed->encode(['user_id' => 1]);
$payload = $signed->decode($token);

Testing

composer install
composer ic:tests

Security

Protected by PHPForge — an automated quality and security gate for PHP projects.

---

_{Made with ❤️ for the PHP community
MIT Licensed}
Documentation • Security • Code of Conduct • Contributing • Report | Request | Suggest