Nextcloud config.php : les in­for­ma­tions es­sen­tielles du fichier de con­fi­gu­ra­tion

Nextcloud config.php est le fichier de con­fi­gu­ra­tion principal du logiciel Cloud, res­pon­sable du contrôle de nombreux aspects fon­da­men­taux du fonc­tion­ne­ment du serveur. Il peut être per­son­na­lisé à l’aide d’un simple éditeur de texte. Toute mo­di­fi­ca­tion doit cependant être effectuée avec pré­cau­tion, car une mauvaise con­fi­gu­ra­tion peut ra­pi­de­ment entraîner des ins­ta­bi­li­tés et des erreurs.

Fichier Nextcloud config.php : de quoi s’agit-il ?

Chez Nextcloud, le config.php fait office de fichier central de con­fi­gu­ra­tion pour de nombreux pa­ra­mètres élé­men­taires du fonc­tion­ne­ment du serveur. On y retrouve notamment les pa­ra­mètres de base de ce dernier, les con­nexions aux bases de données, mais aussi les variables de sécurité et de per­for­mance. Les options de Nextcloud Logging peuvent également y être définies, comme la dé­fi­ni­tion du niveau ou le choix des méthodes de jour­na­li­sa­tion. Tous les pa­ra­mètres Nextcloud ne sont cependant pas inclus dans le fichier config.php. Les pa­ra­mètres des ap­pli­ca­tions Nextcloud, par exemple, sont gé­né­ra­le­ment gérés di­rec­te­ment par les ap­pli­ca­tions elles-mêmes.

Le fichier de con­fi­gu­ra­tion est un outil in­dis­pen­sable pour la per­son­na­li­sa­tion et la gestion de Nextcloud. Il est per­son­na­lisé à la fois lors de l’ins­tal­la­tion du logiciel, lors des mo­di­fi­ca­tions de l’in­fras­truc­ture Cloud et dans le cadre des opé­ra­tions de dépannage. Il est donc important pour les ad­mi­nis­tra­teurs de Nextcloud de savoir comment gérer le fichier config.php.

Format du fichier config.php

En général, le fichier Nextcloud config.php est un fichier texte pur avec un formatage spé­ci­fique pour les dif­fé­rents pa­ra­mètres et valeurs. De cette manière, le fichier est ex­ten­sible et peut interagir fa­ci­le­ment avec le logiciel Nextcloud. Il est également con­sul­table à l’aide de n’importe quel outil de vi­sua­li­sa­tion de texte ou de la ligne de commande.

D’un point de vue technique, le fichier de con­fi­gu­ra­tion est un fichier PHP contenant un tableau spécial appelé $CONFIG. Cette map ordonnée associe des valeurs à des clés. Les dif­fé­rents pa­ra­mètres peuvent cor­res­pondre à dif­fé­rents types de données :

• Integer : nombres entiers comme 0, 1, 2 et 3.
• Float : nombres à virgule flottante comme 1.234 ou 77.55.
• String : chaîne de ca­rac­tères d’une longueur maximale de 4 Ko, comme abcdefg.
• Boolean : valeur booléenne qui est soit true (vrai) soit false (faux).

Char­ge­ment du fichier Nextcloud config.php

Le fichier de con­fi­gu­ra­tion Nextcloud config.php se trouve dans le ré­per­toire d’ins­tal­la­tion de Nextcloud config/ et peut être complété par d’autres données ajoutées à cet em­pla­ce­ment. Pour cela, il est né­ces­saire de nommer le fichier selon le schéma config.php et de le formater cor­rec­te­ment.

Au démarrage, Nextcloud analyse au­to­ma­ti­que­ment l’em­pla­ce­ment config.php pour voir s’il a été modifié, et le fait ré­gu­liè­re­ment en cours d’uti­li­sa­tion. Avec les pa­ra­mètres OPcache par défaut, le logiciel vérifie les mises à jour du ré­per­toire toutes les 2 secondes. Avec la plupart des versions pré­dé­fi­nies, cette durée passe à environ 60 secondes.

Comment modifier le fichier config.php de Nextcloud ?

Pour modifier le fichier Nextcloud config.php, procédez de la manière suivante :

1. Avant de per­son­na­li­ser le fichier de con­fi­gu­ra­tion, vous devez ab­so­lu­ment faire une sau­ve­garde du fichier. La commande est la suivante : sudo cp /var/snap/nextcloud/current/nextcloud/config/config.php config.php.bak.
2. Ensuite, ouvrez le fichier dans votre éditeur de texte avec la commande sudo nano /var/snap/nextcloud/current/nextcloud/config/config.php.
3. Ajoutez les pa­ra­mètres souhaités ou modifiez les entrées exis­tantes.
4. En­re­gis­trez les mo­di­fi­ca­tions et vérifiez ensuite que le serveur Nextcloud fonc­tionne nor­ma­le­ment.

Veillez à ce que la syntaxe soit correcte, car même une virgule manquante ou des guil­le­mets mal placés peuvent affecter l’ensemble du système. Une syntaxe in­cor­recte peut donc non seulement nuire au fonc­tion­ne­ment, mais aussi poser des problèmes de sécurité et entraîner une baisse des per­for­mances. Pour iden­ti­fier et résoudre ra­pi­de­ment les éventuels problèmes, il est re­com­mandé d’effectuer les mo­di­fi­ca­tions étape par étape.

Pré­sen­ta­tion des pa­ra­mètres im­por­tants

Le fichier Nextcloud config.php permet de per­son­na­li­ser un grand nombre de pa­ra­mètres de manière flexible. Vous trouverez la liste complète des pa­ra­mètres de con­fi­gu­ra­tion dis­po­nibles, ac­com­pag­nés de com­men­taires utiles, dans le fichier config.sample.php, installé au­to­ma­ti­que­ment lors de l’ins­tal­la­tion de Nextcloud. Une des­crip­tion détaillée de chaque variable est dis­po­nible dans la do­cu­men­ta­tion de Nextcloud. L’aperçu ci-dessous présente les prin­ci­paux pa­ra­mètres que les ad­mi­nis­tra­teurs doivent connaître pour pouvoir les ajuster au besoin.

Pa­ra­mètres de base

• dbtype : type de base de données
• dbname : nom de la base de données utilisée
• dbhost : nom d’hôte ou adresse IP du serveur de la base de données
• trusted_domains : définit les domaines ou adresses IP à partir desquels l’accès est possible

Ex­pé­rience uti­li­sa­teur

• default.language : définit la langue par défaut
• default.phone.region : définit la région par défaut pour les numéros de téléphone

Session uti­li­sa­teur

• remember_login_cookie_lifetime : définit la durée du cookie de connexion
• session_lifetime : définit après combien de temps une session inactive prend fin

Email

• mail_domain : définit l’adresse de l’ex­pé­di­teur pour les emails sortants