Apache. Hôtes virtuels en mode expert

Dans BeAdmin, un hôte virtuel Apache ne peut être créé qu’en mode expert : la configuration s’édite à la main. Cet article présente le modèle, la vérification de ServerName, la connexion de PHP via PHP-FPM et le travail avec .htaccess. L’installation du module et les modes de fonctionnement sont décrits dans l’article Apache. Démarrage rapide.

Créer un hôte virtuel

Pour configurer un hôte virtuel Apache, vous devez saisir à la main sa configuration au format <VirtualHost>...</VirtualHost>.

Pour créer un hôte :

1. Dans le menu latéral de la section Apache, cliquez sur « Créer un hôte virtuel ».
2. Dans la boîte de dialogue « Initialiser la configuration de l’hôte » qui s’ouvre, indiquez le nom de domaine du site (par exemple example.com). Cette valeur sert au nom du fichier de configuration (example.com.conf) et à la vérification de ServerName.
3. Cliquez sur « Continuer ».
4. L’éditeur s’ouvre avec un modèle <VirtualHost> : adaptez-le à votre site.
5. Cliquez sur « Créer ».

Le modèle standard se présente ainsi :

<VirtualHost *:8808>
    ServerName example.com
    ServerAlias www.example.com

    DocumentRoot /home/www/example.com/public

    <Directory /home/www/example.com/public>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    DirectoryIndex index.php index.html
</VirtualHost>

Rôle de chaque directive :

• <VirtualHost *:8808> — Apache accepte les requêtes sur toutes les interfaces, sur le port 8808.
• ServerName — le domaine principal du site ; il doit correspondre à ce que vous avez saisi dans le formulaire (voir ci-dessous).
• ServerAlias — les domaines et sous-domaines supplémentaires servis par ce même hôte virtuel.
• DocumentRoot — le chemin des fichiers du site sur le disque.
• <Directory ...> — les règles d’un répertoire donné :
  • Options Indexes FollowSymLinks — affiche la liste du contenu du répertoire et autorise le suivi des liens symboliques.
  • AllowOverride All — autorise l’utilisation de .htaccess.
  • Require all granted — ouvre l’accès.
• DirectoryIndex — l’ordre de recherche du fichier d’index quand un répertoire est demandé.

Une fois enregistré, l’hôte apparaît dans le menu latéral et commence aussitôt à recevoir des requêtes (si Apache est démarré). BeAdmin recharge la configuration d’Apache sans redémarrer le service : les connexions ouvertes ne sont pas coupées, et il n’est pas nécessaire de cliquer sur « Recharger la configuration » dans l’en-tête du module.

Port dans le modèle

Le port *:8808 de la première ligne du modèle est le port HTTP de l’association Nginx + Apache, valeur par défaut de BeAdmin pour ce mode. Si Apache fonctionne en mode autonome, remplacez-le par :80, ou par le port que vous avez défini dans la boîte de dialogue d’installation du module. Pour un hôte HTTPS, utilisez :8843 (association) ou :443 (mode autonome). Pour en savoir plus sur les modes et les ports par défaut, consultez l’article Apache. Démarrage rapide.

ServerName doit correspondre au domaine

Le panneau vérifie que les valeurs de ServerName et de ServerAlias dans la configuration sont égales au domaine saisi dans le champ ou se terminent par celui-ci (les sous-domaines *.example.com sont acceptés). Si le champ contient example.com alors que la configuration contient ServerName api.other.com, l’hôte ne peut pas être enregistré.

Gérer un hôte existant

Un hôte ne peut pas être désactivé sans être supprimé : commentez le bloc <VirtualHost> et cliquez sur « Mettre à jour », ou supprimez entièrement le fichier. Pour supprimer un hôte, utilisez l’icône de corbeille à côté de son nom dans le menu latéral.

Connecter PHP via PHP-FPM

Par défaut, le module Apache de BeAdmin installe un Apache nu, sans gestionnaire PHP. Pour connecter PHP, ajoutez un bloc PHP-FPM à l’intérieur du bloc <VirtualHost> (à côté de <Directory>) :

<FilesMatch \.php$>
    SetHandler "proxy:unix:/var/run/php/php8.3-fpm.sock|fcgi://localhost"
</FilesMatch>

Le module PHP de BeAdmin prend en charge plusieurs versions ; chacune crée son propre socket /var/run/php/php<version>-fpm.sock, par exemple php8.3-fpm.sock. Repérez la version d’un site donné dans le module PHP et reportez-la dans SetHandler.

.htaccess et AllowOverride

.htaccess est un fichier contenant des directives Apache, placé dans le répertoire du site. Apache le lit à chaque requête : aucun redémarrage du service n’est nécessaire. Pour que cela fonctionne, le bloc <Directory> de l’hôte doit contenir AllowOverride All ; c’est déjà le cas dans le modèle standard ci-dessus.

Pour modifier .htaccess, ouvrez la section Fichiers de BeAdmin, accédez au répertoire du site et ouvrez le fichier dans l’éditeur. Si le fichier n’existe pas encore, créez-le au même endroit. Les modifications sont prises en compte dès la requête suivante.

Pour aller plus loin

• Apache. Démarrage rapide — présentation du module, modes de fonctionnement, installation.
• Documentation officielle d’Apache HTTP Server — référence des directives, des modules et des modèles MPM.