Inclure un fichier

Objectifs pédagogiques

• Comprendre comment structurer un projet PHP avec plusieurs fichiers.
• Savoir inclure un fichier avec include, require, include_once, require_once.
• Identifier les différences entre ces instructions et leur impact sur l'exécution du code.

Pourquoi inclure un fichier ?

Lorsqu’un projet PHP devient plus complexe, il est recommandé de séparer le code dans plusieurs fichiers pour le rendre plus lisible, modulaire et réutilisable.

Par exemple :

• Un fichier contenant les fonctions
• Un autre contenant le menu HTML
• Un autre pour la configuration

include

L'instruction include permet d’insérer le contenu d’un fichier dans un autre :

// contenu de header.php
echo "<h1>Bienvenue</h1>";

// fichier principal
include "header.php";
echo "Contenu principal";

Si le fichier n’existe pas, PHP affiche un warning mais le script continue de s’exécuter.

require

require fonctionne comme include, mais avec une différence majeure :
si le fichier est introuvable, le script est interrompu.

require "config.php"; // Erreur fatale si le fichier n'existe pas

Utiliser require est donc plus strict, utile pour des fichiers essentiels (configuration, fonctions critiques…).

include_once et require_once

Ces variantes empêchent qu’un même fichier soit inclus plusieurs fois dans un script.

Exemple :

include_once "fonctions.php";
require_once "fonctions.php";

Cela évite les problèmes comme :

• la redéclaration de fonctions
• l’écrasement accidentel de variables

Résumé des différences

Instruction	Erreur si le fichier manque	Inclus plusieurs fois
include	Affiche un warning	Oui
require	Stoppe l'exécution	Oui
include_once	Affiche un warning	Non
require_once	Stoppe l'exécution	Non

Exercice pratique

1. Créer un fichier header.php contenant un titre HTML
2. Créer un fichier footer.php contenant un pied de page
3. Inclure ces fichiers dans un fichier index.php
4. Tester avec include, require, puis avec include_once et require_once
5. Supprimer un fichier temporairement pour observer les comportements