Comment créer un VirtualHost Apache sur Linux pour un projet PHP local

Lorsque l'on développe plusieurs applications PHP sur une machine Debian, utiliser uniquement http://localhost devient rapidement peu pratique.

Les VirtualHosts d'Apache permettent d'associer un nom de domaine local à chaque projet. Par exemple :

• http://mon-projet.local
• http://blog.local
• http://app.local

Chaque nom peut ainsi pointer vers un répertoire différent.

Dans cet article, nous allons voir comment configurer un VirtualHost Apache sur Debian 13 (Trixie) pour un projet PHP local.

L'exemple utilisera :

• Debian 13 ;
• Apache 2.4 ;
• PHP 8.4 ;
• un projet situé dans /var/www/mon-projet ;
• le nom de domaine local mon-projet.local.

Remarque : cette configuration est destinée au développement local. Elle n'est pas une configuration de production.

1. Installer Apache et PHP

Si Apache et PHP ne sont pas encore installés, commencez par mettre à jour la liste des paquets :

Installez ensuite Apache et PHP :

Debian 13 fournit actuellement PHP 8.4 comme version par défaut. Le paquet php est un paquet de dépendance qui pointe vers la version PHP stable fournie par Debian.

Vous pouvez vérifier les versions installées avec :

Vous devriez obtenir quelque chose correspondant à :

et :

Les numéros de révision exacts peuvent naturellement évoluer avec les mises à jour de sécurité de Debian.

Vérifiez également que le service Apache fonctionne :

Si nécessaire :

2. Créer le répertoire du projet

Nous allons placer notre projet dans :

Créez le répertoire :

Pour tester rapidement la configuration, créez un fichier PHP :

Ajoutez :

Enregistrez le fichier.

2.1. À propos des permissions

Apache fonctionne normalement avec l'utilisateur système www-data.

Il n'est cependant pas nécessaire de donner systématiquement la propriété complète du projet à www-data.

Pour un environnement de développement, il est souvent préférable que votre utilisateur Linux reste propriétaire des fichiers du projet et de n'accorder à Apache que les droits dont l'application a réellement besoin.

Pour un simple test, vous pouvez par exemple utiliser :

Les applications nécessitant des répertoires accessibles en écriture, comme Symfony ou Laravel, devront ensuite avoir des permissions adaptées sur leurs répertoires de cache, de logs ou de fichiers uploadés.

3. Créer le VirtualHost Apache

Les configurations des sites Apache sont stockées dans :

Créez le fichier :

Ajoutez la configuration suivante :

3.1. Explications

VirtualHost *:80

Apache écoute ici sur le port HTTP 80, quelle que soit l'adresse IP utilisée par la machine.

Les VirtualHosts basés sur le nom permettent à plusieurs sites de partager la même adresse IP et le même port. Apache sélectionne ensuite le VirtualHost correspondant au ServerName ou au ServerAlias transmis dans la requête HTTP.

ServerName

C'est le nom que nous utiliserons dans le navigateur :

Il est recommandé de définir explicitement un ServerName pour chaque VirtualHost.

DocumentRoot

Cette directive indique à Apache où se trouvent les fichiers du site.

<Directory>

Require all granted autorise Apache à servir le contenu de ce répertoire.

AllowOverride All permet notamment à un fichier .htaccess de modifier certaines règles Apache.

Si votre application n'utilise pas .htaccess, vous pouvez utiliser :

Ce choix est généralement préférable lorsque l'application n'en a pas besoin, car la configuration Apache est alors centralisée.

Les journaux

Les erreurs seront enregistrées dans :

et les accès dans :

4. Ajouter le domaine dans /etc/hosts

Notre domaine mon-projet.local n'existe pas sur Internet.

Il faut donc indiquer à notre machine que ce nom doit correspondre à 127.0.0.1.

Modifiez le fichier /etc/hosts :

Ajoutez :

Vous pouvez également utiliser :

si vous souhaitez utiliser les deux noms.

Le fichier /etc/hosts permet ainsi de simuler localement une résolution DNS. Apache ne crée pas lui-même les entrées DNS correspondant aux VirtualHosts.

Si vous utilisez un autre ordinateur pour accéder au serveur Debian, cette modification doit être effectuée sur la machine cliente, ou remplacée par une véritable configuration DNS.

5. Activer le VirtualHost

Le fichier que nous venons de créer se trouve dans :

Cela signifie qu'il est disponible mais pas encore activé.

Activez-le avec :

Vous pouvez éventuellement désactiver le VirtualHost par défaut d'Apache :

Ce n'est toutefois pas obligatoire pour faire fonctionner notre nouveau VirtualHost.

6. Vérifier la configuration Apache

Avant de recharger Apache, vérifiez toujours sa configuration :

Si tout est correct, vous devez obtenir :

C'est une étape importante : elle permet d'éviter de recharger une configuration contenant une erreur de syntaxe.

Vous pouvez ensuite recharger Apache :

Un reload suffit ici : il permet à Apache de prendre en compte la nouvelle configuration sans arrêter complètement le service.

7. Vérifier les VirtualHosts actifs

Apache fournit une commande très pratique pour examiner les VirtualHosts configurés :

Vous devriez notamment retrouver une ligne correspondant à :

Cette commande est particulièrement utile lorsqu'une machine héberge plusieurs projets et que l'on cherche à comprendre quel VirtualHost Apache utilise. La documentation Apache recommande justement apachectl -S pour diagnostiquer la configuration des VirtualHosts.

8. Tester le site

Vous pouvez maintenant ouvrir votre navigateur et saisir :

Vous devriez voir :

Si vous préférez effectuer le test depuis le terminal :

Vous devriez obtenir le contenu HTML généré par PHP.

Vous pouvez également vérifier directement que PHP est exécuté par Apache en créant temporairement :

avec :

Puis ouvrez :

Vous devriez obtenir la page d'informations PHP.

Supprimez ensuite ce fichier, car phpinfo() expose beaucoup d'informations sur l'environnement PHP :

9. Activer mod_rewrite si nécessaire

De nombreuses applications PHP modernes utilisent le module rewrite d'Apache.

Vous pouvez l'activer avec :

Puis vérifier la configuration :

et recharger Apache :

Avec :

dans le VirtualHost, une application utilisant un fichier .htaccess pourra notamment définir ses propres règles de réécriture.

10. Ajouter plusieurs projets

L'intérêt des VirtualHosts apparaît surtout lorsque plusieurs projets sont installés sur la même machine.

Par exemple :

Vous pouvez créer :

site1.conf

site2.conf

Puis ajoutez les noms dans /etc/hosts :

Activez les deux sites :

Vérifiez la configuration :

Puis rechargez Apache :

Vous pouvez alors accéder aux deux applications avec :

11. Utiliser ServerAlias

Si une application doit être accessible avec plusieurs noms, utilisez ServerAlias.

Par exemple :

Vous pourrez alors utiliser :

ou :

Ajoutez également les deux noms dans /etc/hosts :

Apache utilise ServerName et ServerAlias pour déterminer quel VirtualHost doit répondre à une requête donnée.

12. Faut-il utiliser NameVirtualHost ?

Avec les anciennes versions d'Apache, on pouvait rencontrer une directive de ce type :

Elle n'est pas nécessaire avec Apache 2.4.

Une configuration moderne sous Debian 13 se contente de :

Apache 2.4 gère nativement les VirtualHosts basés sur le nom.

Il est donc inutile d'ajouter NameVirtualHost *:80 à une nouvelle configuration.

13. Structure finale

À ce stade, notre installation ressemble à ceci :

Et /etc/hosts contient :

Le VirtualHost contient :

Conclusion

La création d'un VirtualHost Apache pour un projet PHP sous Debian 13 reste relativement simple.

Les commandes essentielles sont :

Puis :

Ajouter le domaine dans :

Puis activer et vérifier le site :

Enfin :

permet de vérifier les VirtualHosts réellement pris en compte par Apache.

Vous pouvez ensuite accéder à votre projet avec :

Cette méthode permet de reproduire localement une organisation proche d'un serveur web réel, tout en pouvant héberger plusieurs projets PHP indépendants sur une seule machine Debian 13.