Merge branch 'human-geek-main-patch-01100' into 'main'

Ajout de la doc sur le cache

See merge request a-lec/commissions/chalec/nuage!2

README.md

@@ -172,17 +172,74 @@ Un certain nombre de choses sont à configurer (voir la doc officielle pour plus
   'default_phone_region' => 'FR',
 ```
 
+### Mise en place des caches (mémoire, fichiers)
+
+Cette étape est optionnelle mais permet de gagner en réactivité. 
+Une partie des étapes est extraite de la documentation officielle le point d'entrée étant : https://docs.nextcloud.com/server/24/admin_manual/installation/server_tuning.html. 
+N'hésitez pas à vérifier le cas échéant que tout est encore d'actualité.
+
+Attention ces étapes peuvent mettre très briévement votre service hors d'usage. 
+
+#### Mémoire 
+
+##### Apcu
+
+```bash
+apt install php-apcu
+
+```
+Ajouter la ligne suivante au fichier de configuration de nextcloud (config/config.php) en prenant garde à bien respecter le fait qu'il s'agisse d'un tableau (ne pas oublier de virgule par exemple). Plus d'informations peuvent être trouvées sur la documentation de php https://www.php.net/manual/fr/language.types.array.php. 
+
+```php
+  'memcache.local' => '\OC\Memcache\APCu',
+```
+
+##### Redis 
+
+
+Tout d'abord il faut installer le serveur redis et le module php correspondant. 
+
+```bush
+apt install redis php-redis
+```
+
+Attention, ici la machine est protégée du réseau exterieur et pour ne pas avoir a modifier la configuration redis le choix est fait de ne pas écouter sur un socket local. Plus d'informations sont disponible dans la documentation de nextcloud. 
+
+```php
+  'memcache.distributed' => '\OC\Memcache\Redis',
+  'redis' => [
+     'host'     => 'localhost',
+     'port'     => 6379,
+  ],
+```
+
+
+
+#### Fichiers 
+
+Attention cette section par du principe que redis  installé et activé pour la mémoire. Si ce n'est pas le cas et que vous ne souhaitez pas l'activer (pour la mémoire) pensez à installer redis et rajouter les éléments de configuration redis avec les clefs/valeurs host et port dans la configuration de nextcloud.
+Si le prérequis est satisfait il suffit de rajouter dans la configuration de nextcloud (config/config.php). La position des options dans le fichiers n'a pas d'importance. Cela peut être avant ou après le bloc intitulé redis. 
+
+```php
+'filelocking.enabled' => true,
+'memcache.locking' => '\OC\Memcache\Redis',
+```
+
+
+
+
 ### Mise à jour 
 
-Un script existe : 
+Un script existe. Il est préparé pour fonctionner avec une installation apcu. Pour l'executer :
 ```bash 
 cd /var/www/nuage.chalec.org/script`
 bash nextcloud.sh
 ```
 
 
-
-
+### Notes
+
+Sans refaire une installation complète à chaque mise à jour il est possible de passer à coté de certaines évolutions, n'hésitez pas à ouvrir un ticket pour signaler une erreur ou une coquille.