Préparer l’arborescence du site

Avant de déclarer un hôte virtuel, vous devez savoir quels fichiers Apache devra servir et où ils seront placés. Une arborescence claire évite de mélanger les fichiers du site principal, ceux du second hôte et les configurations Apache.

La leçon précédente vous a permis de repérer le service Apache et les emplacements de configuration courants. Ici, vous préparez uniquement les dossiers et les fichiers du projet : aucune configuration globale n’est modifiée et aucun hôte virtuel n’est encore déclaré.

La racine de documents est le dossier dans lequel Apache cherche les fichiers à renvoyer pour un hôte virtuel. Pour ce projet, le contrat fixe /var/www/application pour le site principal et /var/www/api pour le second hôte. Les deux racines restent distinctes : un fichier placé dans l’une n’est pas automatiquement servi depuis l’autre.

Les fichiers sources du site sont organisés selon le contrat du projet : index.html, style.css, journal.html et le dossier apache, qui contiendra les trois fichiers d’hôtes virtuels. Les fichiers de configuration restent hors des racines de documents ; ils ne doivent pas être exposés comme des pages du site.

projet/
├── index.html
├── style.css
├── journal.html
└── apache/
    ├── site-http.conf
    ├── site-https.conf
    └── site-secondaire.conf

/var/www/
├── application/    # racine du site principal
└── api/            # racine du second hôte

Sur le serveur, créez les deux racines de documents. La commande install -d crée les dossiers parents manquants et ne remplace pas les fichiers qui s’y trouvent déjà. Elle nécessite des droits administratifs pour écrire sous /var/www.

sudo install -d /var/www/application /var/www/api
find /var/www/application /var/www/api -maxdepth 0 -type d -print

/var/www/application
/var/www/api

Un fichier d’index est la page d’entrée que le serveur peut renvoyer lorsqu’une requête vise un dossier plutôt qu’un nom de fichier précis. Le projet utilise index.html comme page d’entrée du site principal. Ajoutez-y le squelette HTML fourni pour le projet ; à cette étape, l’objectif est de vérifier que le fichier existe à la racine prévue, sans encore traiter sa mise en forme.

Depuis le dossier du projet, créez également le dossier de configuration et vérifiez les noms des fichiers attendus. La commande touch prépare les fichiers vides ; vous ajouterez leur contenu dans les leçons consacrées aux hôtes virtuels. Ne créez pas de directives Apache à ce stade.

mkdir -p apache
touch index.html style.css journal.html
touch apache/site-http.conf apache/site-https.conf apache/site-secondaire.conf
find . -maxdepth 2 -type f -print | sort

./apache/site-http.conf
./apache/site-https.conf
./apache/site-secondaire.conf
./index.html
./journal.html
./style.css

La vérification confirme que les fichiers du projet sont présents, mais elle ne prouve pas encore qu’Apache peut les lire. Les permissions sur l’arborescence complète seront traitées dans la prochaine leçon ; ne changez pas les propriétaires ou les modes d’accès de manière arbitraire.

• La racine de documents détermine depuis quel dossier Apache sert les fichiers d’un hôte.
• Le projet sépare les racines /var/www/application et /var/www/api.
• index.html est préparé comme page d’entrée du site principal.
• Les fichiers de configuration restent dans le dossier apache, hors des racines de documents.
• La vérification des permissions et l’association des hôtes virtuels viendront dans les prochaines leçons.