mini\Mini\ApcuDrivers\ArrayApcuDriver class

Documentation

ArrayApcuDriver - Simple in-memory APCu polyfill using static array

Provides APCu-compatible caching when neither APCu extension nor Swoole is available. Data is stored in a static array and persists only for the lifetime of the PHP process.

Limitations:

  • Not shared between PHP-FPM workers or processes
  • Cleared on each request in PHP-FPM (but persists in CLI/long-running processes)
  • No memory limits (can grow unbounded)
  • TTL cleanup only happens on access (lazy expiration)

Best used as a fallback or for testing when real APCu is unavailable.

Inheritance

Implements: mini\Mini\ApcuDrivers\ApcuDriverInterface

Uses Traits: mini\Mini\ApcuDrivers\ApcuDriverTrait

Properties (1)

private static array $data

In-memory storage: key => payload

Methods (27)

protected _fetch()

Fetch raw payload from static array.

protected _add()

Atomic "add if not exists" (SETNX) - single-threaded, so no actual locking needed.

protected _store()

Unconditional overwrite (SET).

protected _delete()

Delete a key.

public info()

apcu_cache_info(): return basic stats about the array cache.

public sma_info()

apcu_sma_info(): no real allocator, return stub.

public clear_cache()

apcu_clear_cache(): wipe the static array.

public enabled()

apcu_enabled(): this driver is always enabled (no dependencies).

protected packValue()

Encode a value and its expiry into a payload string.

protected unpackValue()

Decode payload into value + expiry.

protected computeExpiresAt()

Compute logical expiry from TTL.

protected backendTtl()

Convert logical expiry to backend TTL.

protected lockKey()

Documentation missing

protected acquireLock()

Documentation missing

protected releaseLock()

Documentation missing

protected withLock()

Documentation missing

protected maybeGarbageCollect()

Probabilistic garbage collection - randomly triggers on write operations.

public fetch()

apcu_fetch

public add()

apcu_add

public store()

apcu_store

public delete()

apcu_delete

public exists()

apcu_exists

public entry()

apcu_entry

public cas()

apcu_cas

public inc()

apcu_inc

public dec()

apcu_dec

public key_info()

apcu_key_info (minimal)

Source

src/Mini/ApcuDrivers/ArrayApcuDriver.php:18-133