astral-php / astral-cache

0.1.0 2026-10-29 10:29 UTC

Requires

• php: ^8.3
• astral-php/astral-core: ^2.0

Requires (Dev)

• phpunit/phpunit: ^10.5 || ^11.0

Suggests

• ext-memcache: Driver Memcache historique (Windows / Laragon)
• ext-memcached: Driver Memcached (Linux / Docker)
• ext-redis: Driver Redis (CACHE_DRIVER=redis)

MIT

• astral-php

• php
• cache
• mvc
• astral

Published on Packagist.org on 2026-10-29 10:32 UTC

README

Cache multi-drivers opt-in pour Astral MVC — array, file, core, Redis, Memcache(d).

Explicite, sans magie. Provider facultatif. Aucune dépendance Redis/Memcache dans astral-core.

Compatibilité

• PHP ^8.3
• astral-php/astral-core ^2.0

Installation

Local (path) :

"repositories": [{ "type": "path", "url": "../astral-cache" }]

composer require astral-php/astral-cache:@dev

Packagist (après publication) : composer require astral-php/astral-cache.

Fusionner stubs/.env.cache.example dans le .env de l’app.

Usage minimal (sans provider)

use Astral\Cache\CacheRepository;
use Astral\Cache\Store\FileStore;

$cache = new CacheRepository(new FileStore(__DIR__ . '/../storage/cache', 'astral:'));

$users = $cache->remember('users.all', 3600, fn () => $dao->findAll());
$cache->forget('users.all');

Service Provider (optionnel)

Dans config/dependencies.php :

Astral\Cache\CacheServiceProvider::class,

Puis injection :

use Astral\Cache\CacheRepository;

public function __construct(private CacheRepository $cache) {}

Variable	Défaut	Rôle
CACHE_DRIVER	file	file | array | core | redis | memcache
CACHE_PATH	storage/cache	Répertoire file / core
CACHE_PREFIX	astral:	Préfixe de clés
CACHE_TTL	3600	TTL défaut (secondes)
REDIS_*	localhost	Uniquement si CACHE_DRIVER=redis
MEMCACHE_*	localhost:11211	Uniquement si memcache

Sémantique (alignée Core\Cache 2.0)

Règle	Comportement
null	has() = true si entrée valide ; get() peut retourner null
TTL	Secondes int ≥ 1 ; sinon InvalidArgumentException
Valeurs	Scalaires / tableaux ; pas d’objets
clear() / flush()	Limité au store / préfixe (jamais FLUSHDB / flush Memcache serveur)
remember()	Best-effort (pas de lock stampede)

Drivers

Driver	Extension	Notes
array	—	Processus courant
file	—	Défaut install simple
core	—	Adaptateur Core\Cache (migration)
redis	ext-redis	clear() = SCAN + DEL préfixe
memcache	ext-memcache ou ext-memcached	Laragon = souvent Memcache ; clear() = bump génération

Tests

composer install
composer test

Les suites Redis / Memcache se skipent si extension ou serveur absent.

Liens

• Spec : astral-informations/astral-cache/Roadmap/spec-astral-cache-2.0.md
• Core Cache 2.0 : astral-informations/astral-core/Roadmap/spec-cache-2.0.md