infocyph/intermix

A Collection of useful PHP class functions.

5.3 2025-06-22 10:53 UTC

Requires

• php: >=8.2
• opis/closure: ^4.3
• psr/cache: ^3.0
• psr/container: ^2.0
• psr/simple-cache: ^3.0

Requires (Dev)

• captainhook/captainhook: ^5.24
• laravel/pint: ^1.20
• pestphp/pest: ^3.7
• rector/rector: ^2.0
• symfony/var-dumper: ^7.2

Suggests

• ext-apcu: For APCu-based caching (in-memory, per-process)
• ext-memcached: For Memcached-based caching (distributed, RAM)
• ext-pdo: For SQLite-based caching (file-based, portable)
• ext-redis: For Redis-based caching (persistent, networked)
• ext-sqlite3: For SQLite-based caching (file-based, portable)

MIT

• abmmhasan

• container
• dependency
• cache
• reflection
• di
• injection
• mixin
• memoize
• macro
• intermix

README

InterMix is a modern, lightweight PHP toolkit for developers who love class-oriented design, clean architecture, and fast execution. From dependency injection to dynamic macros, every utility is designed to just work — with minimal config and maximum control.

🚀 Key Features

• Dependency Injection (DI) — PSR-11 compliant container with:
  • attribute-based injection
  • scoped lifetimes
  • lazy loading
  • environment-specific overrides
  • debug tracing & cache support
• Caching — Dual PSR-6 & PSR-16 compatible cache engine
• Fence — Enforce singleton-style class safety
• MacroMix — Dynamically extend objects or classes with macros
• Memoizer — once() and memoize() helpers for deterministic caching
• Global Utilities — Like pipe(), retry(), measure(), flatten(), and more

📦 Installation

composer require infocyph/intermix

Supported PHP versions:

InterMix Version	PHP Version
2.x.x and above	8.2 or newer
1.x.x	8.0–8.1 compatible

⚡ 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();
}

See full container guide at: 📖 https://intermix.readthedocs.io/en/latest/di/overview.html

🧬 Dynamic Macros

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

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

🧠 once() Memoization

use function Infocyph\InterMix\Remix\once;

$value = once(fn() => rand(1000, 9999)); // Only runs once per file+line

📚 Documentation

Full documentation available on ReadTheDocs:

🔗 https://intermix.readthedocs.io

Includes:

• ✅ Getting Started & Quickstart
• 📦 DI Container Guide (bindings, scopes, attributes, lifetimes)
• 🧩 Modules: Memoizer, Fence, MacroMix
• 🧪 Testing & Caching Tips
• 📘 PDF/ePub formats

✅ Testing

composer install
composer test

🤝 Contributing

Got ideas or improvements? Join us!

📂 Open issues 📬 Submit a PR — we welcome quality contributions

🛡 License

MIT Licensed — use it freely, modify it openly.

🔗 opensource.org/licenses/MIT