Structure de répertoires de ServBay

La structure des répertoires de ServBay est simple et claire. Si vous avez des connaissances de base sur les systèmes Linux/Unix, vous constaterez qu'elles sont très similaires.

Une structure de répertoire typique de ServBay est la suivante :

ServBay
|____backup
| |____config
| |____hosts
|____bin
|____data
| |____servbay
|____db
| |____redis
|____etc
|____logs
|____package
| |____bin
| |____common
| | |____imap-uw
| | |____include
| | |____lib
| | |____libexec
| | |____openssl
| | |____share
| |____etc
| | |____caddy
| | |____dnsmasq
| | |____mariadb
| | |____openldap
| | |____php
| | |____redis
| | |____scws
| |____mariadb
| | |____x.x
| |____node
| | |____xx
| |____php
| | |____x.x
| |____sbin
| |____var
| | |____log
| | |____run
|____sbin
|____script
|____ssl
| |____caddy
|____tmp
|____www
| |____servbay

Nous expliquerons ci-dessous l'utilisation de chaque répertoire en détail.

Répertoire principal

Le répertoire principal de ServBay est situé à '/Applications/ServBay', où tous les fichiers sont stockés.

Pour effectuer une sauvegarde (par exemple avec Time Machine ou d'autres méthodes), veuillez sauvegarder ce répertoire dans son intégralité.

Répertoire racine du site web

Le répertoire racine du site web est situé à '/Applications/ServBay/www'. Il est recommandé de créer un dossier pour chaque hôte afin de maintenir une structure claire et facile à gérer.

Par exemple :

/Applications/ServBay/www
|____com
| |____servbay
| | |____web               # web.servbay.com
| | |____support           # support.servbay.com
| | |____api               # api.servbay.com
|____local
| |____sam
| | |____www               # www.sam.local
| |____servbay
| | |____new               # new.servbay.local

Répertoire des fichiers de configuration

Le répertoire des fichiers de configuration est situé à '/Applications/ServBay/etc', c'est un lien symbolique ; les fichiers réels sont stockés dans '/Applications/ServBay/package/etc'.

Dans la plupart des cas, vous pouvez utiliser directement '/Applications/ServBay/etc'.

Voici des exemples de fichiers de configuration pour des logiciels courants :

PHP

Le répertoire des fichiers de configuration de PHP a une structure à deux niveaux. Sous etc/php, il y a des répertoires pour les différentes versions, tels que 5.6, 7.4, 8.3 etc., avec une structure typique comme suit :

php
|____5.6
| |____conf.d
|____7.0
| |____conf.d
| |____php-fpm.d
|____7.4
| |____conf.d
| |____php-fpm.d
|____8.3
| |____conf.d
| |____php-fpm.d
|____8.4
| |____conf.d
| |____php-fpm.d

Dans chaque répertoire de version, il y a des fichiers tels que php.ini, php-fpm.conf, pear.conf, etc. Après avoir modifié ces fichiers, vous devez redémarrer le service PHP correspondant pour appliquer les dernières modifications.

Le répertoire conf.d est destiné aux configurations d'extensions PHP, contenant des fichiers comme xdebug.ini, opcache.ini, redis.ini, etc. En éditant ces fichiers, vous pouvez charger, décharger ou modifier diverses extensions PHP. De même, après modification, vous devez redémarrer le service PHP correspondant pour appliquer les modifications.

Note : Chaque version mineure partage la même configuration que la version majeure. Par exemple, 8.3.3 et 8.3.5 partagent les fichiers de configuration de 8.3.

MariaDB

Le répertoire des fichiers de configuration de MariaDB a également une structure à deux niveaux, par exemple etc/mariadb/11.2. Le dossier ne contient qu'un seul fichier my.cnf, qui doit être redémarré pour prendre effet après modification. Chaque version mineure et majeure partage les mêmes configurations.

Caddy

Note : Les fichiers Caddyfile sont générés automatiquement par ServBay, ne les modifiez pas. Toute modification sera automatiquement écrasée. Pour des paramètres personnalisés, configurez directement dans l'onglet hôte de ServBay.

dnsmasq

Le répertoire contient deux fichiers principaux : dnsmasq.conf et domains.conf. dnsmasq.conf est le fichier de configuration par défaut et domains.conf est le fichier de domaine généré automatiquement.

Note : Les fichiers dnsmasq.conf et domains.conf sont générés automatiquement par ServBay, ne les modifiez pas. Toute modification sera automatiquement écrasée.

Répertoire des paramètres de ServBay

/Applications/ServBay/data

Ce répertoire contient les fichiers de configuration et informations nécessaires au bon fonctionnement de ServBay. Veuillez vérifier régulièrement vos sauvegardes et éviter de supprimer ou de modifier ce répertoire.

Répertoires des fichiers exécutables et des scripts

/Applications/ServBay/bin -> package/bin
/Applications/ServBay/sbin -> package/sbin
/Applications/ServBay/script

Tous les fichiers exécutables de ServBay se trouvent dans les répertoires bin et sbin. Cela inclut les différentes versions de PHP, Node, etc., les liens symboliques sont créés vers ces deux répertoires.

Ces répertoires contiennent de nombreux outils courants, tels que curl, openssl, frpc, ainsi que les différentes versions de PHP et Node.

Par exemple, vous pouvez utiliser php-5.6 pour exécuter un script avec PHP 5.6 ou node-15 pour exécuter un script avec Node.js 15 non LTS.

Le répertoire script mérite une mention spéciale. Il contient les scripts système de ServBay, utilisés pour démarrer et arrêter les services, initialiser les bases de données, etc. Vous pouvez exécuter ces scripts directement, mais évitez de les modifier ou de les supprimer.

Ces scripts sont tous emballés dans servbayctl. Vous pouvez exécuter servbayctl directement pour effectuer des opérations. Par exemple :

servbayctl start php 7.0

Répertoire des fichiers de base de données

/Applications/ServBay/db

Comme le répertoire etc, le répertoire db a une structure multi-niveaux. Chaque version mineure et majeure partage une base de données unique. Lors du développement quotidien, veuillez vérifier vos sauvegardes pour ce répertoire.

Répertoire des journaux

/Applications/ServBay/logs -> package/var/log

Tous les journaux de ServBay sont stockés ici. À l'exception de PHP et XDebug, qui génèrent plusieurs fichiers stockés dans un sous-répertoire de deuxième niveau, les autres journaux sont stockés dans les sous-répertoires de chaque service correspondant.

Les journaux d'accès au site web sont stockés dans le répertoire caddy, classés par domaine.

Les journaux PHP sont divisés en deux : php-fpm.log (journaux générés par php-fpm) et errors.log (journaux d'erreurs). errors.log est généré uniquement en cas d'erreur d'exécution du code non capturée et enregistrée par le framework PHP.

Par exemple, les journaux d'erreurs générés par Laravel sont stockés dans le répertoire storage/logs/laravel.log du framework SDK de Laravel, alors que les journaux d'erreur générés par WordPress et trongate peuvent être trouvés dans errors.log.

Note : Les fichiers journaux occupent beaucoup d'espace, veuillez les nettoyer régulièrement.

Répertoire des paquets logiciels

/Applications/ServBay/package

Ce répertoire contient tous les paquets logiciels installés par ServBay, avec une structure de nom_du_paquet/version_majeure/version_mineure. Par exemple, package/php/8.3/8.3.7.

Pour les versions anciennes non nécessaires après une mise à jour, vous pouvez les supprimer manuellement pour économiser de l'espace.

Note : Dans chaque dossier, il y a un lien symbolique nommé current, pointant vers la version de paquet la plus récente, ne le supprimez pas, sinon cela entraînera l'échec du démarrage de certains services.

Répertoire des certificats SSL

/Applications/ServBay/ssl

Ce répertoire contient les certificats SSL, y compris le certificat racine SSL local (CA).

Répertoire de sauvegarde

/Applications/ServBay/backup

Ce répertoire est utilisé par ServBay pour les sauvegardes automatiques, pour l'instant utilisé seulement pour sauvegarder le fichier '/etc/hosts'.

Répertoire des fichiers temporaires

/Applications/ServBay/tmp

Ce répertoire contient des fichiers .pid générés par chaque service, ainsi que les fichiers de socket de PHP, MariaDB, PostgreSQL, tels que php-cgi.sock, mysql.sock, etc.

Dans le développement quotidien, en plus d'accéder aux services comme php-fpm et bases de données via le port TCP, il est possible d'accéder à ces services via les fichiers de socket. Les fichiers de socket offrent généralement un débit plus élevé, de meilleures performances et une latence plus faible que les ports TCP.

Composants communs et bibliothèques de développement

/Applications/ServBay/package/common

Ce répertoire contient les composants communs nécessaires à toutes les applications de ServBay, tels que divers fichiers *.dylib.

Si vous avez installé la ServBay Development Library, ce répertoire contient également include, et sous lib il y a divers fichiers *.la, *.a. Ces fichiers sont nécessaires pour la recompilation et les en-têtes.

Note : Ne supprimez pas les fichiers lib/*.dylib, sinon certains programmes risquent de manquer de bibliothèques critiques et de rencontrer des erreurs.