PHP Fichiers d'inclusion
Instructions include et require en PHP
Les instructions include et require prennent tout le texte, le code ou le balisage qui existent dans un fichier et les insèrent dans le fichier qui utilise l'instruction include/require.
Inclure des fichiers est très utile pour réutiliser du code ou du texte sur plusieurs pages web !
Les instructions include et require sont identiques, sauf en cas d'échec :
-
includeproduira un avertissement (E_WARNING) mais le script continuera à s'exécuter -
requireproduira une erreur fatale (E_ERROR) et le script s'arrêtera
Si vous souhaitez que l'exécution se poursuive et montre aux utilisateurs la sortie, même si le fichier d'inclusion est manquant, utilisez l'instruction include . Cela peut être judicieux pour des fichiers comme les en-têtes, les pieds de page ou les menus de navigation.
Si vous souhaitez que l'exécution s'arrête en cas d'échec, utilisez l'instruction require . Cela est recommandé pour les fichiers de configuration ou les connexions à la base de données.
Syntaxe
include 'filename'; ou require 'filename'; Pied de page d'inclusion PHP
Inclure des fichiers permet d'économiser beaucoup de travail. Cela signifie que vous pouvez créer un fichier d'en-tête, de pied de page ou de menu standard pour toutes vos pages web. Ensuite, lorsque l'en-tête doit être mis à jour, vous pouvez simplement mettre à jour le fichier d'inclusion de l'en-tête.
Supposons que nous ayons un fichier de pied de page standard appelé "footer.php", qui ressemble à ceci :
<?php
echo "<p>Droits d'auteur © 1999-" . date("Y") . " formation-ti.org</p>";
?> Pour inclure le fichier de pied de page dans une page, utilisez l'instruction include :
Exemple
<html>
<body>
<h1>Bienvenue sur ma page d'accueil !</h1>
<p>Un peu de texte.</p>
<p>Encore un peu de texte.</p>
<?php include 'footer.php';?>
</body>
</html> Menu de navigation d'inclusion PHP
Supposons que nous ayons un fichier de menu standard appelé "menu.php" :
<?php
echo '<a href="/default.asp">Accueil</a> -
<a href="/html/default.asp">Tutoriel HTML</a> -
<a href="/css/default.asp">Tutoriel CSS</a> -
<a href="/js/default.asp">Tutoriel JavaScript</a> -
<a href="default.asp">Tutoriel PHP</a>';
?> Toutes les pages du site Web devraient utiliser ce fichier de menu. Voici comment cela peut être fait (nous utilisons un élément <div> afin que le menu puisse facilement être stylisé avec CSS plus tard) :
Exemple
<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>Encore un peu de texte.</p>
</body>
</html> Variables d'inclusion PHP
Supposons que nous ayons un fichier appelé "vars.php", avec quelques variables définies :
<?php
$color='rouge';
$car='BMW';
?> Ensuite, si nous incluons le fichier "vars.php", les variables peuvent être utilisées dans le fichier appelant :
Exemple
<html>
<body>
<h1>Bienvenue sur ma page d'accueil !</h1>
<?php include 'vars.php';
echo "J'ai une $color $car.";
?>
</body>
</html> include PHP vs. require
Si un fichier est inclus avec l'instruction include 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 une $color $car.";
?>
</body>
</html> Si un fichier est inclus avec l'instruction require et que PHP ne peut pas le trouver, l'instruction echo ne sera pas exécutée car l'exécution du script s'arrête après que require renvoie une erreur fatale :
Exemple
<html>
<body>
<h1>Bienvenue sur ma page d'accueil !</h1>
<?php require 'noFileExists.php';
echo "J'ai une $color $car.";
?>
</body>
</html> Utilisez require si le fichier d'inclusion est requis par l'application.
Utilisez include si le fichier d'inclusion n'est pas requis et que le code peut continuer, même si le fichier d'inclusion n'est pas trouvé.