Fichiers Include PHP

Le serveur-side include (SSI) est utilisé pour créer des fonctions, des en-têtes, des pieds de page ou des éléments réutilisables sur plusieurs pages.

L'instruction include (ou require) récupère tous les textes / codes / balises existants dans le fichier spécifié et les copie dans le fichier utilisant l'instruction include.

L'inclusion de fichiers est très utile si vous devez引用相同的 PHP, HTML ou texte sur plusieurs pages de votre site.

Instructions include et require en PHP

Par l'intermédiaire des instructions include ou require, vous pouvez insérer le contenu d'un fichier PHP dans un autre PHP (avant qu'il soit exécuté sur le serveur).

Les instructions include et require sont identiques, sauf pour la gestion des erreurs :

  • require génère des erreurs fatales (E_COMPILE_ERROR) et arrête le script
  • include génère uniquement des avertissements (E_WARNING) et le script continue

Par conséquent, si vous souhaitez continuer à exécuter et à afficher des résultats à l'utilisateur, même si le fichier d'inclusion est manquant, utilisez include. Sinon, dans les cadres, les CMS ou les applications PHP complexes, utilisez toujours require pour inclure des fichiers clés dans le flux d'exécution. Cela aide à améliorer la sécurité et l'intégrité de l'application, en cas de perte accidentelle d'un fichier clé.

L'inclusion de fichiers économise beaucoup de travail. Cela signifie que vous pouvez créer des en-têtes, des pieds de page ou des menus standard pour toutes les pages. Ensuite, lorsque vous devez mettre à jour l'en-tête, vous n'avez qu'à mettre à jour le fichier d'inclusion d'en-tête.

Syntaxe

include 'filename';

ou

require 'filename';

Exemple de PHP include

Exemple 1

Supposons que nous ayons un fichier de pied de page standard nommé "footer.php", comme ceci :

<?php
echo "<p>Copyright © 2006-" . date("Y") . " codew3c.com</p>";
?>

Pour inclure ce fichier de pied de page sur une page, utilisez l'instruction include :

<html>
<body>
<h1>Bienvenue sur notre page d'accueil !</h1>
<p>Un texte.</p>
<p>Un texte.</p>
<?php include 'footer.php';?>
</body>
</html>

Exemple de fonctionnement

Exemple 2

Supposons que nous ayons un fichier de menu standard nommé "menu.php" :

<?php
echo '<a href="/index.asp">Accueil</a> -
<a href="/html/index.asp">Tutoriel HTML</a> -
<a href="/css/index.asp">Tutoriel CSS</a> -
<a href="/js/index.asp">Tutoriel JavaScript</a> -
<a href="/php/index.asp">Tutoriel PHP</a>';
?>

Toutes les pages du site utilisent ce fichier de menu. La méthode consiste en (nous utilisons un élément <div> pour que nous puissions facilement appliquer des styles CSS à l'avenir) :

<html>
<body>
<div class="menu">
<?php include 'menu.php';?>
</div>
<h1>Bienvenue sur ma page d'accueil !</h1>
<p>Un peu de texte.</p>
<p>Un peu plus de texte.</p>
</body>
</html>

Exemple de fonctionnement

Exemple 3

Supposons que nous ayons un fichier nommé "vars.php" qui définit quelques variables :

<?php
$color='Argenté';
$car='Voiture Berline';
?>

Ensuite, si nous référençons ce fichier "vars.php", nous pouvons utiliser ces variables dans le fichier appelé :

<html>
<body>
<h1>Bienvenue sur ma page d'accueil !</h1>
<?php
include 'vars.php';
echo "Je possède un" . $color . $car.".";
?>
</body>
</html>

Exemple de fonctionnement

PHP include vs. require

L'instruction require est également utilisée pour référencer des fichiers dans le code PHP.

Cependant, il y a une énorme différence entre include et require : si une instruction include est utilisée pour référencer un fichier et que PHP ne peut pas le trouver, le script continuera à s'exécuter :

Exemple

<html>
<body>
<h1>Bienvenue sur ma page d'accueil !</h1>
<?php
include 'noFileExists.php';
echo "J'ai un $color $car.";
?>
</body>
</html>

Exemple de fonctionnement

Si nous utilisons l'instruction require pour achever le même cas, l'instruction echo ne continuera pas à s'exécuter, car le script se termine après que l'instruction require a renvoyé une erreur grave :

Exemple

<html>
<body>
<h1>Bienvenue sur ma page d'accueil !</h1>
<?php
require 'noFileExists.php';
echo "J'ai un $color $car.";
?>
</body>
</html>

Exemple de fonctionnement

Remarque :

Utilisez require à ce moment : lorsque le fichier est demandé par l'application.

Utilisez include à ce moment : lorsque le fichier n'est pas nécessaire et que l'application doit continuer à fonctionner lorsque le fichier n'est pas trouvé.