Formation PUB010 : PHP, 2022 Structure des dossiers

4.1 Vous avez dit racine ?


Selon le Grand Dictionnaire Terminologique de l'Office québécois de la langue française1, le mot racine signifie :

Dans une structure de données arborescente, élément à la source de tous les autres.

Dans un projet Web, il y a plusieurs racines qu'il faut bien distinguer afin de comprendre comment effectuer les bonnes configurations et déterminer à quel endoit il faut placer les fichiers.

Voici une structure de dossiers typique pour un projet PHP. Elle est illustrés sous Windows et sous Mac pour un projet PHP vanille développé localement avec AMPPS.

Racines sous Windows             Racines sous Mac

Si vous travaillez dans un environnement tel que Devilbox, votre structure de dossiers ressemblera plutôt à ceci. Notez que la racine du disque n'a pas été illustrée puisque Devilbox permet d'effectuer l'installation n'importe où sur votre disque.

Racines sous Devilbox

Racine du disque

La racine du disque se passe d'explications.

Racine du serveur

La racine du serveur est l'endroit où il faut placer les fichiers PHP et autres pour que le serveur HTTP (ex : Apache, Nginx) puisse les interpréter et ainsi afficher les pages du site Web.

Il s'agit généralement d'un dossier dont le nom ressemble à www ou à public_html. Le nom et l'emplacement de ce dossier peuvent être modifiés à l'aide des fichiers de configuration du serveur HTTP.

Pour accéder à la racine du serveur pendant le développement d'un projet local, on peut utiliser l'URL http://localhost ou l'adresse IP http://127.0.0.1.

Racine du projet

La racine du projet est le dossier dans lequel touts les fichiers du projet sont placés. On créera un dossier par projet afin de permettre au serveur HTTP d'héberger plusieurs sites Web.

Racine du site ou de l'application Web

La racine du site est l'endroit où le nom de domaine doit pointer. C'est l'endroit à partir duquel le navigateur peut accéder aux ressources du site Web comme ses fichiers PHP, CSS, JS, ses images, etc.

Il s'agit parfois du même dossier que la racine du projet, comme illustré dans les images précédentes.

Avec nom de domaine local

Pendant le développement du site Web, il est possible de travailler avec un nom de domaine local (ex : monsite.test). Dans un environnement tel que Devilbox, ceci est d'ailleurs une obligation et le nom de domaine local est sous la forme monsite.dvl.to.

Le nom de domaine local pointe toujours sur le dossier racine du site (ex : /Applications/AMPPS/www/monsite ou .../devilbox/data/www/monsite).

 

Sans nom de domaine local

Dans certains environnements, il est possible de ne pas utiliser de nom de domaine local. Vous utiliserez alors l'URL http://127.0.0.1/monsite pour accéder au site.

À ce moment, la balise <link rel="icon" href="/favicon.ico"> recherchera le fichier favicon.ico à la racine du serveur, ce qui ne donnera pas les résultats escomptés. Lorsque vous travaillez sans nom de domaine local, il faut éviter d'utiliser des URL qui débutent par une barre oblique.

Avec nom de domaine local - projet Laravel

Dans certains cadres d'application, par exemple Laravel, le nom de domaine doit pointer sur un sous-dossier, par exemple le sous-dossier public.

Plusieurs raisons justifient cette configuration, notamment des raisons de sécurité. En effet, ceci assure que tous les fichiers qui ne sont pas sous le dossier public ne pourront pas être accédés directement dans le navigateur. On pourra donc conserver dans le dossier du projet des fichiers sensibles comme des fichiers journaux ou des fichiers de configuration sans risquer qu'un hacker puisse les afficher dans son navigateur.

Racines dans un projet Laravel

Site chez un hébergeur Web

Lorsque vous travaillez avec un forfait d'hébergement partagé, votre compte sera généralement associé à un nom de domaine. Il s'agit du nom de domaine principal de votre hébergement.

Si votre forfait vous permet d'héberger plusieurs sites Web, chacun pourra avoir son propre nom de domaine. Les autres noms de domaine seront qualifiés de domaines supplémentaires, ou, en anglais, addon domains.

L'emplacement de la racine du site sera différente selon qu'il s'agit du site principal ou des sites supplémentaires.

Racines des sites chez l'hébergeur

Source

1. « Fiche terminologique - racine ». Office québécois de la langue française. http://www.granddictionnaire.com/ficheOqlf.aspx?Id_Fiche=8431040

▼Publicité

Veuillez noter que le contenu de cette fiche vous est partagé à titre gracieux, au meilleur de mes connaissances et sans aucune garantie.
Merci de partager !

Site fièrement hébergé chez A2 Hosting.

Soumettre