snapflowio/registry

A simple and lightweight library to pass resources around applications.

v0.1.0 2025-12-17 01:49 UTC

Requires

• php: >=8.4

Requires (Dev)

• laravel/pint: *

MIT

• Bryan Lawless

README

A simple and lightweight library to pass resources around applications.

Installation

composer require snapflowio/registry

Quick Start

<?php

use Snapflow\Registry\Registry;

$registry = new Registry();

// Register a service with a factory callback
$registry->set('database', function () {
    return new PDO('mysql:host=localhost;dbname=myapp', 'user', 'pass');
});

// Get the service (lazy initialization, only created when first accessed)
$db = $registry->get('database');

// Subsequent calls return the same instance
$sameDb = $registry->get('database');

// Register services that always create fresh instances
$registry->set('timestamp', fn () => microtime(true), fresh: true);

// Use contexts for isolation (e.g., per-request, per-test)
$registry->context('testing')->set('database', function () {
    return new PDO('sqlite::memory:');
});

// Check if a service is registered
if ($registry->has('database')) {
    $db = $registry->get('database');
}

// Method chaining
$registry
    ->context('api')
    ->set('logger', fn () => new Logger())
    ->set('cache', fn () => new Cache());

// Info and cleanup
$services = $registry->getRegistered(); // ['database', 'timestamp', 'logger', 'cache']
$currentContext = $registry->getContext(); // 'api'
$registry->clear(); // Clear instances in current context
$registry->remove('cache'); // Remove service completely

License

This library is available under the MIT License.

Copyright

Copyright (c) 2025 Snapflow