Organiser le code : l'architecture MVC

Trois rôles, trois dossiers

Une arborescence courante :

souk-atlas/
├── index.php              ← contrôleur frontal (seul fichier appelé par le navigateur)
├── config/db.php          ← connexion PDO
├── controllers/ProduitController.php
├── models/ProduitModel.php
└── views/
    ├── liste.php
    └── detail.php

Le chemin d’une requête

Un require à l’intérieur d’une méthode donne à la vue accès aux variables locales de cette méthode : c’est ainsi que $produit arrive dans detail.php, sans variable globale.

Le modèle

<?php
class ProduitModel
{
    public function __construct(private PDO $pdo) {}

    public function trouver(int $id): array|false
    {
        $req = $this->pdo->prepare('SELECT p.*, c.nom AS categorie
                                    FROM produits p JOIN categories c ON c.id = p.categorie_id
                                    WHERE p.id = ?');
        $req->execute([$id]);
        return $req->fetch();
    }
}

Le modèle reçoit $pdo dans son constructeur au lieu de créer sa propre connexion : on parle d’injection de dépendance. Tous les modèles partagent ainsi la même connexion.

Pourquoi c’est utile

• Chacun sa partie : l’intégrateur travaille sur les vues, le développeur back-end sur les modèles.
• Réutilisation : ProduitModel::trouver sert à la fiche, au panier et à l’API (leçon D.2).
• Une URL, un point d’entrée : la session, la sécurité et la connexion se règlent une seule fois dans index.php.
• Pas de surprise en arrivant sur un framework : Laravel et Symfony suivent la même logique, avec un routage plus riche (/produits/9 au lieu de ?action=detail&id=9).