Migration vers

Ce changement nécessitait un point d'd’entrée unique : toutes les requêtes passent désormais par index.php, qui distribue le travail selon l'l’URL demandée. C'C’est ce que fait F3.

Le patron MVC — Modèle · Vue · Contrôleur

MVC est une façon d'd’organiser son code en 3 rôles bien séparés, pour ne pas tout mélanger dans un seul fichier.

Schéma simple du flux :

Visiteur

Avantage concret : si demain tu veux changer la mise en page de la liste des articles, tu touches seulement articles.html. Si tu veux changer comment les données sont filtrées, tu touches seulement ArticleController.php. Les deux ne se mélangent pas.

3. ⚡ Fat Free Framework (F3) — le chef d'd’orchestre

F3 est un micro-framework PHP. "Framework"“Framework” = boîte à outils qui donne une structure. "Micro"“Micro” = il reste très léger, sans des dizaines de fichiers de configuration.

Son rôle principal dans notre projet : le routage. Il lit l'l’URL demandée et appelle le bon contrôleur.

// Dans index.php — on dit à F3 : "si quelqu'un va sur /articles,
// appelle la méthode liste() dans ArticleController"
$f3->route('GET /articles', 'ArticleController->liste');
$f3->route('GET /article/@slug', 'ArticleController->detail');
// @slug = la partie variable de l'URL (ex: "corogna-2024")

F3 s's’occupe aussi du moteur de templates : il lit les fichiers .html des vues, remplace les {{ @variables }} par les vraies valeurs, et produit le HTML final envoyé au navigateur.

Les grands frameworks (Laravel, Symfony) sont très puissants mais ont une courbe d'd’apprentissage importante et beaucoup de "magie"“magie” cachée. F3 fait exactement ce dont on a besoin, sans surplus. Un seul fichier PHP de 200 Ko, aucune configuration complexe.

4. 📦 Composer — le gestionnaire de librairies

Composer est le gestionnaire de paquets PHP. C'C’est l'l’équivalent ded’un ce qu'est l'App Store pour ton téléphonestore : il télécharge et installe des librairies quecréées d'par d’autres développeurs ont créées.développeurs.

Tu écris dans un fichier composer.json : "j'“j’ai besoin de F3 et de lad’une librairie pour manipuler des vidéos"vidéo”. Composer va sur internet, télécharge tout ça, et le place dans un dossier vendor/. Plus besoin de le faire manuellement.

On a installé deux librairies pour notrece projet :

Le dossier vendor/ est exclu de Git (dans .gitignore) car il peut être recréé à tout moment avec la:

composer install.

5. 🔗 Les URLs propres — comment ça fonctionne

Pour que toutes les URLs passent par index.php, on utilise un fichier .htaccess à la racine du site.site C'est un fichier de configuration Apache qui dit : "si le fichier ou dossier demandé n'existe pas physiquement, envoie la requête vers index.php"(Apache).

# .htaccess — la règle clé
RewriteEngine On
# Si ce n'est pas un vrai fichier ET pas un vrai dossier...
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# ...redirige vers index.php
RewriteRule .* index.php [L,QSA]

Quand quelqu'quelqu’un va sur /article/corogna-2024 :

Avec les URLs propres, les chemins d'd’images relatifs cassent.cassent Sur: la pagesur /article/corogna-2024, une image uploads/photo.jpg est interprétée par le navigateur commedevient /article/uploads/photo.jpg → introuvable. Il faut toujours utiliserUtiliser des chemins absolus commençant par / : /uploads/photo.jpg.

6. 🎨 Les templates F3 — séparer le HTML du PHP

Dans l'l’ancien site, le PHP et le HTML étaient mélangés dans le même fichier.mélangés. Avec F3, le contrôleur prépare les données, puis les "envoie"“envoie” à un fichier HTML pur. Ce fichier HTML utilise une syntaxe spéciale pour afficher les données.(vue).

Syntaxe principale :

<!-- Afficher une variable (avec protection HTML automatique) -->
{{ @article.titre }}

<!-- Afficher du HTML pré-généré sans l'échapper -->
{{ @contenu_html | raw }}

<!-- Condition if/else -->
<check if="{{ @article.photo }}">
  <true><img src="{{ @article.photo }}" /></true>
  <false><div>Pas de photo</div></false>
</check>

<!-- Boucle foreach -->
<repeat group="{{ @articles }}" value="{{ @a }}">
  <h2>{{ @a.titre }}</h2>
</repeat>

F3 compile ces templates en PHP dans un dossier tmp/. Il ne recompile que si le fichier HTML source a changéchangé. —Si c'estune plusvue rapide.ne Quandse onmet modifiepas unà template, on peutjour, vider le cache en supprimant les fichiers tmp/*.php.

Le template HTML est comme un formulaire avec des cases vides. Le contrôleur PHP remplit les cases avec les vraies données. F3 est le mécanisme qui fait la liaison entre les deux.

Structure du projet — qui fait quoi

html/

Les layouts — le "moule"“moule” des pages

Un layout est le cadre commun à plusieurs pages. Au lieu de recopier la navbar et le footer dans chaque page,partout, on les met une seule fois dans le layout.

┌─────────────────── simple.html (layout) ──────────────────┐

On a deux layouts :

PHP 8.4 — pièges rencontrés et leçons apprises

On tourne sur PHP 8.4, la: version la plus récente. Cette version est plus stricte que les anciennes :stricte, certaines choses qui "passaient"“passaient” avant provoquent maintenant des erreurs.

Piège n°1 — Variable non définie = erreur fatale

Si un template F3 essaie d'afficheraffiche {{ @ma_variable }} et que cette variable n'n’a pas été définie, PHP 8.4 lancepeut déclencher une erreur. En mode debug F3erreur (en DEBUG=3),3 ça se traduit par une: page blanche avec le code/ HTTP 500.500).

Solution : dans BaseController.php, on initialise toutesinitialiser les variables optionnelles àdans une valeur vide par défautBaseController.php :

// Dans BaseController::render()
$f3->set('page_description', '');
// ← valeur vide par défaut
$f3->set('extra_head',       '');
$f3->set('extra_scripts',   '');

Piège n°2 — Clé de tableau manquante

Accéder à $tableau['ma_cle'] quand la clé n'n’existe pas → "“Undefined array key"key”. Par exemple, les types de modalités "groupe" et "enseignants-personnels" n'avaient pas de clé conditions, mais le template essayait d'y accéder.

Solution : toujours s'assurergarantir que toutes les clés existent, même avec une valeur videvides :

// Bien : la clé 'conditions' existe toujours (tableau vide si pas de conditions)
'groupe' => [
    'intro'      => "...",
    'items'      => [...],
    'conditions' => [], // ← vide mais présent
]

Comment diagnostiquer les erreurs :

On a une méthode efficace pour trouver les bugs rapidement :

10. 📖 Lexique — les termes à retenir