Page 13 : Architecture des Actions Administratives

En tant qu’ingénieur senior, la première chose que je veux vous transmettre est l’importance d’une structure propre et répétable. Pour toutes nos actions d’administration (Ajout, Liste, Modif, Suppression), nous suivons un schéma strict.

1. Séparation de la Logique et de l’Affichage

Chaque action est divisée en deux parties :

Le Contrôleur (Logique) : Fichiers comme admin-add-article.php. Ils gèrent la base de données, la sécurité et les redirections. Ils ne contiennent JAMAIS de balise <div> ou <h1>.
La Vue (Affichage) : Fichiers comme resources/views/admin/articles/add-article_html.php. Ils contiennent le HTML et n’affichent que des variables déjà préparées.

2. Le Mécanisme de Mise en Mémoire Tampon (`ob_start`)

C’est une technique avancée pour injecter dynamiquement du contenu dans un Layout global. Voici comment cela fonctionne dans nos fichiers admin :

// 1. On démarre le tampon (on bloque l'envoi au navigateur)
ob_start();

// 2. On inclut la vue spécifique
require_once 'resources/views/admin/articles/ma-vue_html.php';

// 3. On récupère le HTML généré dans une variable et on vide le tampon
$pageContent = ob_get_clean();

// 4. On injecte cette variable dans le layout global
require_once 'resources/views/layouts/admin-layout/admin-layout_html.php';

3. Sécurité au Sommet du Fichier

Chaque fichier d’administration commence par une barrière de sécurité infranchissable :

declare(strict_types=1);
session_start();
require_once 'database/database.php';

if ($_SESSION['role'] !== 'admin') {
    header('Location: index.php');
    exit();
}

Pourquoi c’est important ?

declare(strict_types=1) : Force PHP à être rigoureux sur les types de données (évite les erreurs silencieuses).
session_start() : Permet d’accéder aux informations de l’utilisateur connecté.
$_SESSION['role'] !== 'admin' : C’est notre garde du corps. Si quelqu’un essaie d’accéder à l’URL sans être admin, il est immédiatement éjecté vers la page d’accueil.

Dans les pages suivantes, nous allons décortiquer chaque action étape par étape.