ajoute le cache Redis sur les lectures lourdes (bloc B)

Catalogue (labs, banque de quiz officielle, cours) et liste des
classes du tableau de bord prof - jamais d'expiration, invalidation
explicite par les commandes de synchronisation et par
archiver/désarchiver/purge RGPD.

Bug trouvé en vérifiant en réel sur le serveur (pas en local, où
CACHE_STORE=array ne sérialise jamais rien) : mettre en cache des
modèles Eloquent hydratés plante à la relecture via Redis
("incomplete class" à l'unserialize). Corrigé en cachant les attributs
bruts et en reconstruisant de vrais modèles avec Model::hydrate().

Mesuré en réel : 5 appels directs = 5 requêtes SQL, 5 appels via le
cache = 1 requête SQL.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Adam Belkacemi 2026-10-14 07:34:55 +02:00
parent ecf3dfb21d
commit ca544ac620
15 changed files with 250 additions and 10 deletions

View file

@ -0,0 +1,69 @@
<?php
namespace App\Services\Catalogue;
use App\Models\Cours;
use App\Models\Lab;
use App\Models\Quiz;
use Illuminate\Database\Eloquent\Collection;
use Illuminate\Support\Facades\Cache;
/**
* Cache Redis des lectures lourdes du catalogue (bloc B, 2026-10-14) :
* labs, banque de quiz officielle, cours. Change seulement quand les
* commandes de synchronisation tournent (déploiement) — jamais d'expiration,
* invalidé explicitement par ces mêmes commandes. Trié par identifiant,
* à chaque appelant de retrier en mémoire s'il veut un autre ordre (peu de
* lignes, pas besoin d'une deuxième entrée de cache).
*
* Le cache stocke les attributs bruts (`getAttributes()`), pas les modèles
* eux-mêmes : sérialiser un objet PHP et le relire plus tard (processus
* différent, éventuellement unserialize() avant que l'autoloader ait tout
* chargé) peut échouer avec « incomplete class » — ce qui s'est produit en
* vérifiant ce chantier en réel. Un tableau de scalaires n'a pas ce risque ;
* `Model::hydrate()` reconstruit ensuite de vrais modèles, casts compris.
*/
class CacheCatalogue
{
/** @return Collection<int, Lab> */
public static function labs(): Collection
{
return Lab::hydrate(Cache::rememberForever(
'catalogue:labs',
fn () => Lab::orderBy('identifiant')->get()->map->getAttributes()->all()
));
}
/** @return Collection<int, Quiz> */
public static function quizOfficiels(): Collection
{
return Quiz::hydrate(Cache::rememberForever(
'catalogue:quiz-officiels',
fn () => Quiz::where('partage', true)->whereNotNull('theme')->withCount('questions')->orderBy('theme')->get()->map->getAttributes()->all()
));
}
/** @return Collection<int, Cours> */
public static function cours(): Collection
{
return Cours::hydrate(Cache::rememberForever(
'catalogue:cours',
fn () => Cours::orderBy('identifiant')->get()->map->getAttributes()->all()
));
}
public static function viderLabs(): void
{
Cache::forget('catalogue:labs');
}
public static function viderQuizOfficiels(): void
{
Cache::forget('catalogue:quiz-officiels');
}
public static function viderCours(): void
{
Cache::forget('catalogue:cours');
}
}