Mettre en place les fichiers et les conventions

Quand un projet PHP grandit, un fichier unique finit par mélanger les requêtes, les règles du carnet et le HTML. Vous allez poser une structure qui permet de retrouver chaque responsabilité sans encore implémenter les contacts ni la connexion à MySQL.

Le périmètre fonctionnel et les champs d’un contact ont été définis dans la leçon précédente. Ici, vous préparez les emplacements où le code correspondant sera ajouté progressivement.

Créer l’arborescence du projet

Créez les répertoires et fichiers indiqués ci-dessous, en respectant exactement leur nom et leur emplacement. public contiendra les ressources accessibles depuis le navigateur et le point d’entrée ; src accueillera le code applicatif ; templates regroupera les gabarits destinés à l’affichage.

public/
├── index.php
└── style.css
src/
├── Configuration/
│   └── BaseDeDonnees.php
├── Modele/
│   └── Contact.php
├── Depot/
│   └── ContactDepot.php
├── Service/
│   └── Authentification.php
└── Controleur/
    ├── ContactControleur.php
    └── AuthentificationControleur.php
templates/
├── gabarit.php
├── connexion.php
├── contacts.php
├── contact-formulaire.php
└── erreur.php

Les noms de répertoires suivent le contrat du projet, notamment les majuscules de Configuration, Modele, Depot, Service et Controleur. Ne renommez pas les fichiers et ne déplacez pas les gabarits : les prochaines étapes s’appuieront sur ces chemins précis.

Appliquer les conventions PHP

Chaque fichier PHP commence par la balise d’ouverture PHP, puis par declare(strict_types=1);. Cette déclaration demande à PHP d’appliquer le typage strict aux appels concernés depuis ce fichier. Placez-la avant toute instruction ou sortie ; un espace ou du texte envoyé avant la déclaration peut empêcher son bon fonctionnement.

<?php

declare(strict_types=1);

Utilisez ce contenu minimal comme point de départ dans public/index.php et dans chaque fichier PHP créé, y compris ceux des répertoires src et templates. À ce stade, le point d’entrée ne fait encore aucun traitement : il existe pour fixer le chemin d’accès principal du site. La gestion de la session, le routage et l’appel aux contrôleurs viendront plus tard.

Garder chaque fichier à sa place

Le nom de chaque fichier indique son rôle attendu. BaseDeDonnees.php servira à la configuration PDO, Contact.php au modèle, et ContactDepot.php aux échanges avec la table. Les fichiers de contrôleur traiteront les actions ; les fichiers du répertoire templates porteront l’affichage. Cette séparation prépare le flux page, traitement et base décrit précédemment, sans le réimplémenter ici.

Appliquez également PSR-12 : indentation régulière de quatre espaces, accolades placées selon les conventions PHP, lignes lisibles et une instruction par ligne. Écrivez les noms de variables et de fonctions en français, par exemple $recherche ou trouverContacts. Les prochaines leçons introduiront les déclarations et structures nécessaires ; ne remplissez pas encore les fichiers avec des fonctions ou des classes anticipées.

Laissez public/style.css vide pour l’instant. Lorsqu’une règle de présentation sera nécessaire, elle ira dans cette feuille unique et utilisera les classes et variables CSS du contrat. N’ajoutez pas de classes ou de variables de présentation au hasard : le HTML et le style seront construits en suivant le squelette de référence.

À retenir

• Respectez exactement l’arborescence et les noms de fichiers prévus par le contrat.
• Placez declare(strict_types=1); au début de chaque fichier PHP.
• Suivez PSR-12 et utilisez des noms français pour les variables et fonctions.
• Gardez les traitements, les modèles et les gabarits dans leurs répertoires respectifs.
• Laissez les fichiers de présentation et les comportements futurs pour les leçons qui leur sont consacrées.

Dans la prochaine leçon, vous préciserez les types des valeurs échangées par cette structure.