Emplacement et gestion des fichiers de configuration ServBay

ServBay est une solution puissante pour le développement Web local, centrée sur la gestion flexible de divers paquets logiciels (tels que serveurs Web, bases de données, runtimes de langages, etc.). Afin de simplifier leur gestion et d'assurer la stabilité de l'environnement, ServBay centralise tous les fichiers de configuration et applique une structure de répertoires claire. Cet article détaille les emplacements des fichiers de configuration de ServBay et guide les développeurs pour localiser et consulter ces fichiers essentiels.

Avis important : Ne modifiez jamais les fichiers de configuration manuellement

Les fichiers de configuration de ServBay sont générés automatiquement par l'application en fonction de vos réglages (via l'interface utilisateur). N'éditez jamais directement les fichiers de configuration situés dans /Applications/ServBay/etc ou autres répertoires ServBay.

Une modification manuelle risque fortement d'être écrasée lors d'une mise à jour, d'un redémarrage d'un service ou d'une modification effectuée via l'UI, entraînant la perte de vos changements ou des erreurs imprévues.

Toutes les modifications doivent être faites via l'interface graphique (UI) fournie par ServBay ou les outils en ligne de commande officiels, afin de garantir la durabilité des changements et la stabilité du système. Cet article vous renseigne sur les chemins de fichiers, principalement pour vous aider à comprendre la structure interne de ServBay ou à effectuer des vérifications lors du dépannage.

Vue d’ensemble de la structure des répertoires

Les fichiers de configuration de ServBay sont principalement localisés dans les répertoires centraux suivants, classés par nom et version de package :

• /Applications/ServBay/etc : c’est le dossier principal des configurations ServBay. Il contient la majorité des fichiers de serveurs Web (Nginx, Caddy, Apache), des runtimes de langages (par ex. le php.ini de PHP), des bases de données (paramètres de MySQL/MariaDB), et d’autres services (Redis, Memcached, etc.).
• /Applications/ServBay/db : ce répertoire stocke essentiellement les données des bases de données, mais abrite aussi certains fichiers de configuration spécifiques, comme les fichiers de contrôle d’accès de PostgreSQL.
• /Applications/ServBay/package/common : ce dossier contient des paquets partagés comme OpenSSL, dont les fichiers de configuration sont également regroupés ici.

Emplacement détaillé des fichiers de configuration des paquets

Voici quelques exemples d’emplacement des fichiers de configuration pour les paquets les plus courants dans ServBay :

Serveurs Web

Les fichiers de configuration des serveurs Web se trouvent généralement sous /Applications/ServBay/etc, avec un sous-répertoire par nom de serveur, puis par version.

• Nginx : Dossier principal : /Applications/ServBay/etc/nginx Par exemple, fichier de conf. pour Nginx 1.25 :

  /Applications/ServBay/etc/nginx/1.25/nginx.conf

  D’autres fichiers associés (site web, SSL…) sont en général organisés dans ce même répertoire ou ses sous-dossiers.

• Caddy : Dossier principal : /Applications/ServBay/etc/caddy Fichier principal de configuration :

  /Applications/ServBay/etc/caddy/Caddyfile

• Apache : Dossier principal : /Applications/ServBay/etc/apache Par exemple, fichier de conf. pour Apache 2.4 :

  /Applications/ServBay/etc/apache/2.4/httpd.conf

  Les configurations de virtual hosts sont généralement dans le sous-dossier extra.

Runtimes de langages

Les environnements d’exécution pour différents langages (PHP, Python, Node.js, Go, Java, etc.) ont leurs fichiers sous /Applications/ServBay/etc, triés par langage et version.

• PHP : Dossier principal : /Applications/ServBay/etc/php Par exemple, le php.ini pour PHP 8.2 :

  /Applications/ServBay/etc/php/8.2/php.ini

  La configuration PHP-FPM se trouve généralement dans ce même dossier de version.

• Python : La configuration de Python passe en général par les variables d’environnement ou des fichiers internes au projet. L’environnement Python fourni par ServBay localise ses exécutables sous /Applications/ServBay/package/python/{version}/bin, tandis que la configuration globale n’est que rarement gérée dans /etc par ServBay.

• Node.js, Go, Java, Ruby, Rust, .NET : À l’instar de Python, la configuration de ces langages dépend largement du projet, des variables d’environnement ou des conventions propres aux toolchains. ServBay fournit l’exécution ou le SDK, mais ne centralise pas leurs fichiers de configuration sous /Applications/ServBay/etc.

Bases de données

Les fichiers de configuration des bases de données sont répartis entre /Applications/ServBay/etc et /Applications/ServBay/db.

• MySQL / MariaDB : Dossier principal : /Applications/ServBay/etc/mysql (ou /Applications/ServBay/etc/mariadb) Exemple pour MySQL 8.0 :

  /Applications/ServBay/etc/mysql/8.0/my.cnf

  Ce fichier couvre la plupart des paramètres majeurs de la base.

• PostgreSQL : Le fichier principal de conf. est sous /Applications/ServBay/etc/postgresql, trié par version. Exemple pour PostgreSQL 16 :

  /Applications/ServBay/etc/postgresql/16/postgresql.conf

  Cependant, les fichiers liés à l’authentification client (pg_hba.conf et pg_ident.conf) se trouvent dans /Applications/ServBay/db/postgresql, également par version :

  /Applications/ServBay/db/postgresql/16/pg_hba.conf
  /Applications/ServBay/db/postgresql/16/pg_ident.conf

• MongoDB, Redis : Leurs fichiers de configuration sont généralement sous /Applications/ServBay/etc, classés par nom et version. Par exemple, le chemin pour Redis :

  /Applications/ServBay/etc/redis/redis.conf

Autres services & paquets communs

• OpenSSL : Les fichiers de configuration OpenSSL sont localisés dans /Applications/ServBay/package/common/openssl, par version. Par exemple pour OpenSSL 3.2 :

  /Applications/ServBay/package/common/openssl/3.2/openssl.cnf

• ACME (pour la gestion automatisée des certificats SSL) : Les paramètres ACME et les certificats s’enregistrent généralement sous /Applications/ServBay/etc/acme ou /Applications/ServBay/db/acme.

Localiser et consulter le contenu des fichiers de configuration

Bien qu’il soit déconseillé de modifier les fichiers à la main, il est parfois utile de les consulter pour vérifier la configuration actuelle ou diagnostiquer un problème. Procédez ainsi :

1. Accédez au répertoire concerné : Utilisez un terminal (Terminal, iTerm2, etc) pour naviguer jusqu’au dossier voulu. Par exemple, pour consulter la configuration Nginx :

   cd /Applications/ServBay/etc/nginx/

   Pour accéder au dossier contenant le pg_hba.conf de PostgreSQL 16 :

   cd /Applications/ServBay/db/postgresql/16

2. Lister les fichiers : Utilisez la commande ls pour afficher les fichiers du répertoire :

   ls

3. Afficher le contenu d’un fichier : Consultez le fichier avec un utilitaire texte (cat, less, more) ou un éditeur (comme vim, nano – pour visualisation uniquement, ne sauvegardez aucune modification). Par exemple, relire le nginx.conf :

   cat nginx.conf
   # Ou utilisez less pour un affichage paginé
   less nginx.conf

   Pour afficher le php.ini de PHP 8.2 :

   less /Applications/ServBay/etc/php/8.2/php.ini

4. Redémarrer un service (en cas de modification via ServBay UI) : Après toute modification via l’UI, redémarrez le service concerné pour appliquer les changements. Cela se fait via l’interface ServBay ou l’outil de commande servbayctl. Par exemple, pour redémarrer Nginx :

   servbayctl restart nginx -all

   Redémarrer PHP 8.2 :

   servbayctl restart php 8.2

   Redémarrer tous les services :

   servbayctl restart all

Foire aux questions (FAQ)

• Q : Puis-je éditer manuellement un fichier de configuration pour tester des réglages avancés ?

  R : Il est fortement déconseillé de modifier directement les fichiers. L’UI de ServBay couvre la plupart des besoins standards. Pour des personnalisations avancées non supportées par l’UI, référez-vous à la documentation avancée de ServBay ou sollicitez la communauté. Une modification manuelle peut être écrasée très facilement.

• Q : Comment ServBay gère-t-il les configurations multi-versions ?

  R : Comme expliqué, chaque version d’un paquet possède son propre sous-dossier dans /Applications/ServBay/etc ou /Applications/ServBay/db, isolant ainsi chaque configuration et évitant les conflits entre versions.

• Q : Que faire si j’efface ou corromps un fichier de configuration ?

  R : ServBay génère les fichiers de configuration à partir de modèles internes selon vos réglages. En général, effectuer une modification (même minime) depuis l’UI sur le paquet concerné forcera la régénération du fichier. En cas de problème sévère, essayez de réinitialiser la configuration ou contactez le support ServBay.

Conclusion

ServBay adopte une gestion centralisée et structurée des fichiers de configuration, principalement située sous le dossier /Applications/ServBay/etc, complétée par /Applications/ServBay/db et /Applications/ServBay/package/common. Cette organisation facilite la gestion automatique par ServBay et la consultation par les développeurs.

Comprendre l’emplacement de ces fichiers permet de mieux appréhender le fonctionnement de ServBay et de diagnostiquer d’éventuels problèmes. Encore une fois : toutes modifications doivent être faites via les outils officiels et l’interface fournie par ServBay – n’altérez jamais les fichiers de configuration manuellement pour préserver la stabilité de votre environnement ServBay.