perf: cache locking, TTL map, purge script and SW LRU limit

scripts/purge-cache.php

@@ -0,0 +1,21 @@
+<?php
+/**
+ * Vide le cache API de l'application (fichiers cache/api/cache_*.json).
+ *
+ * Usage : php scripts/purge-cache.php [répertoire-cache]
+ *
+ * Utile après un changement de configuration ou pour forcer le
+ * rafraîchissement des données externes (PeerTube, Castopod, Funkwhale)
+ * sans attendre l'expiration des entrées.
+ *
+ * Contrairement à warm-cache.php, ce script ne charge pas config.php :
+ * purger le cache ne nécessite aucun appel API. Le paramètre optionnel
+ * de répertoire sert essentiellement aux tests automatisés.
+ */
+
+require_once __DIR__ . '/../includes/simple-cache.php';
+
+$cache = new SimpleAPICache($argv[1] ?? null);
+$deleted = $cache->clear();
+
+echo "Cache purgé : {$deleted} entrée(s) supprimée(s).\n";