Global Helper Functions

CacheLayer autoloads helper functions from src/functions.php.

sanitize_cache_ns()

sanitize_cache_ns(string $ns) → string

Normalizes namespaces into safe key prefixes.

Behavior:

• Replaces any character outside [A-Za-z0-9_-] with _

• Uses an internal static memoization map for repeated inputs

Example:

sanitize_cache_ns('tenant/acme.v1');
// "tenant_acme_v1"

memoize()

memoize(?callable $callable = null, array $params = []) → mixed

Two modes:

• memoize() returns the singleton Infocyph\CacheLayer\Memoize\Memoizer

• memoize($callable, $params) executes memoized call lookup for global/static scope

Example:

$f = fn (int $x): int => $x + 1;

$a = memoize($f, [5]);
$b = memoize($f, [5]);

// same cached result

remember()

remember(?object $object = null, ?callable $callable = null, array $params = []) → mixed

Object-scoped memoization helper.

Two modes:

• remember() returns the singleton Memoizer

• remember($object, $callable, $params) caches value per object instance

If object is provided but callable is missing, it throws InvalidArgumentException.

once()

once(callable $callback) → mixed

Executes callback once per call site context using Infocyph\CacheLayer\Memoize\OnceMemoizer.

Useful for one-time initialization inside request/process scope.

$config = once(function () {
    return loadLargeConfigArray();
});