Différences

Ci-dessous, les différences entre deux révisions de la page.

--- technique:adminserv:nextcloud:php [2022/04/14 17:33] – qduchemi
+++ technique:adminserv:nextcloud:php [2023/06/10 19:42] (Version actuelle) – qduchemi
@@ Ligne 1: / Ligne 1: @@
+{{indexmenu_n>10}}
+## Modifier un paramètre PHP ou PHP-FPM
+### Cas général
+Picasoft utilise une image Nextcloud qui fait tourner [PHP-FPM](https://www.php.net/manual/fr/install.fpm.php), permettant d'appeler des scripts PHP depuis `nginx` de façon efficace.
+Traditionnellement, PHP se configure grâce à un fichier `php.ini`. Cependant, ce fichier contient de nombreuses directives, potentiellement modifiées par Nextcloud au fil des mises à jour.
+<bootnote warning>
+Malgré ce qui est indiqué dans un [bout de sa documentation](https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/big_file_upload_configuration.html#configuring-upload-limits-within-the-gui), écraser la configuration dans le fichier `.user.ini` ne semble pas être le plus pertinent : il contient déjà des directives qui n'ont pas été remplies par nous.
+</bootnote>
+La meilleure solution est :
+- Pour PHP : monter un fichier `.ini` dans `/usr/local/etc/php/conf.d/`. C'est ce qui [est fait actuellement](https://gitlab.utc.fr/picasoft/projets/services/nextcloud-pica/-/blob/9662f0502e1cc1ca057a532cae9a45955c3a4384/docker-compose.yml#L21).
+- Pour PHP-FPM : monter un fichier `.conf` dans `/usr/local/etc/php-fpm.d`. C'est ce qui [est aussi fait actuellement](https://gitlab.utc.fr/picasoft/projets/services/nextcloud-pica/-/blob/9662f0502e1cc1ca057a532cae9a45955c3a4384/docker-compose.yml#L22).
+<bootnote>La version de PHP utilisée par Nextcloud est compilée avec l'option `--with-config-file-scan-dir=/usr/local/etc/php/conf.d`. Tous les fichiers `.ini` de ce dossier seront donc inclus dans la configuration, [par ordre alphabétique](https://www.php.net/manual/fr/configuration.file.php). C'est pour cela que notre fichier commence par `z`, pour être inclus à la fin. Pour PHP-FPM c'est la même limonade, la compilation met le fichier de configuration à `/usr/local/etc/php-fpm.`, qui inclue ensuite tous les fichiers `.conf` de `/usr/local/etc/php-fpm.d`.</bootnote>
+Il suffit donc de modifier un des ces fichiers sur le dépôt et de redémarrer le conteneur applicatif.
+### Cas d'application
+Assez souvent, notre instance est très lente, voir finit par envoyer des _timeout_ (HTTP 504), notamment sur la synchronisation des calendriers. Les logs donnent un avertissement :
+```
+[14-Apr-2022 13:40:32] WARNING: [pool www] server reached pm.max_children setting (5), consider raising it
+```
+Cette valeur désigne le « nombre maximum de processus fils à créer lorsque `pm` est réglé sur `dynamic` » et « affecte la limite du nombre de requêtes simultanées qui seront servies » ([source]). En d'autres termes, la configuration de base de Nextcloud n'autorise que 5 requêtes servies simultanément!
+Après quelques recherches, cette [réponse sur Reddit](https://www.reddit.com/r/NextCloud/comments/9e5ljv/nextcloud_and_phpfpm_adjustments/e5ppadx/) donne des valeurs qui semblent plus adéquates à la situation :
+```
+[www]
+pm = dynamic
+pm.max_children = 50
+pm.start_servers = 15
+pm.min_spare_servers = 15
+pm.max_spare_servers = 25
+pm.max_requests = 500
+```
+Comme ces valeurs concernent PHP-FPM, il suffit de les ajouter dans le fichier [zz-php-fpm-custom.conf](https://gitlab.utc.fr/picasoft/projets/services/nextcloud-pica/-/blob/master/zz-php-fpm-custom.conf), puis de redémarrer le conteneur.
+### Vérifier les paramètres
+#### Pour PHP
+<bootnote web>Idée prise [ici](https://docs.nextcloud.com/server/latest/admin_manual/issues/general_troubleshooting.html#php-version-and-information).</bootnote>
+Se rendre dans le conteneur et créer un fichier `phpinfo.php` qui affiche la configuration PHP. Exemple :
+```bash
+$ docker exec -it nextcloud-app sh
+echo "<?php phpinfo(); ?>" > phpinfo.php
+```
+Puis visiter [cette page](https://cloud.picasoft.net/phpinfo.php).
+<bootnote warning>Leaker toute la configuration est dangereux, à ne faire que parcimonieusement et penser à supprimer le fichier après usage.</bootnote>
+#### Pour PHP-FPM
+Depuis le conteneur, on peut récupérer les paramètres de la configuration pour voir s'ils sont bien pris en compte :
+```bash
+$ php-fpm -tt
+[...]
+[14-Apr-2022 15:41:49] NOTICE: 	pm = dynamic
+[14-Apr-2022 15:41:49] NOTICE: 	pm.max_children = 50
+[14-Apr-2022 15:41:49] NOTICE: 	pm.start_servers = 15
+[14-Apr-2022 15:41:49] NOTICE: 	pm.min_spare_servers = 15
+[14-Apr-2022 15:41:49] NOTICE: 	pm.max_spare_servers = 25
+[14-Apr-2022 15:41:49] NOTICE: 	pm.process_idle_timeout = 10
+[...]
+```
+Pour voir les paramètres runtime :
+TODO : https://www.php.net/manual/fr/fpm.status.php
+<bootnote warning>Certains paramètres ne sont pas affichés sur cette page et il semble n'y avoir [aucun moyen d'y accéder](https://serverfault.com/questions/878096/how-to-check-current-pm-max-children-setting).</bootnote>