Langage PHP

Inclure des portions de page include, require

PHP propose plusieurs fonctions d'inclusion de fichiers : include, include_once, require et require_once.

À quoi servent ces différentes fonctions ? En quoi sont-elles différentes ? Nous allons répondre à ces questions dans la suite de ce tutoriel.

La fonction include :

La fonction include est utilisée pour inclure un fichier au sein du processus courant. Elle prend un argument en entrée : la chaîne de caractères qui correspond au chemin du fichier.

<?php
include 'header.php';
?>
<div id="content">
....
</div>
<?php
include 'footer.php';
?>

Cette fonction peut être utilisée dans un système de template PHP quand vous avez un entête de page qui sera la même sur toutes les pages. Dans ce cas, vous pouvez placer le code correspondant à l'entête dans un seul fichier, qui sera par la suite inclus dans toutes vos pages.

Si le fichier que vous essayez d'inclure n'est pas trouvé, PHP renverra alors un warning. Le chemin du fichier passé en paramètre peut être absolu ou relatif.

La fonction include_once:

Cette fonction est la même que sa « mère » include à ceci près que le fichier ne sera inclus qu'une seule fois.

La fonction include vous autorise à inclure plusieurs fois le même fichier grâce à une boucle par exemple.

Mais si on reprend cette boucle en utilisant include_once à la place, le fichier ne sera inclus qu'une seule fois.

<?php
foreach ($produits as $produit) {
   include_once 'produit.php';
}
?>

L'utilisation la plus courante de cette fonction est lorsque vous avez plusieurs fonctions définies dans le fichier qui sera inclus. Pour éviter d'avoir des erreurs sur la redéfinition de fonctions, on utilise include_once pour n'inclure le fichier qu'une seule et unique fois.

La fonction require:

La fonction require agit de la même manière que sa « sœur » include à ceci près qu'elle génère une erreur si le fichier à inclure n'est pas trouvé. Comme son nom l'indique, le fichier est requis pour que l'application fonctionne.

L'erreur générée s'il y a lieu sera une E_COMPILE_ERROR qui arrête l'application là où la fonction include génère un warning qui n'influe pas le fonctionnement de l'application.

La fonction require s'utilise exactement de la même manière que les précédentes.

<?php
require 'page.php';
?>

La fonction require_once:

La dernière des quatre fonctions est require_once, qui est une combinaison des fonctions require et include_once. De ce fait cette fonction s'assure d'abord que le fichier à inclure existe bien, et si ce n'est pas le cas, génère une erreur. Puis elle s'assure que le fichier n'est utilisé qu'une seule fois.

<?php
require_once 'header.php';
?>

<div id="content">
....
</div>

<?php
require_once 'footer.php';
?>


Partager ce cours avec tes amis :
Rédigé par Mostafa Sedoki
Professeur d'Informatique dans les CPGE

Cours Similaires :