Inclure un fichier dans une page PHP

Vous pouvez facilement inclure le même contenu sur plusieurs pages de votre site à l'aide de fichiers d'inclusion, fichiers qui sont inclus de façon dynamique dans une page Web lorsque la page est rendue dans le navigateur.

Les fichiers d’inclusion peuvent faciliter la gestion des sites. Par exemple, vous pouvez créer du contenu tel qu’une bannière de page, un bloc d’informations sur le site ou un menu à inclure dans plusieurs pages de votre site. Lorsque vous souhaitez modifier le contenu, vous pouvez effectuer la modification dans un fichier unique ; celle-ci sera ensuite répercutée sur chaque page dans laquelle apparaît le fichier d’inclusion.

Une instruction PHP d’inclusion est un bloc de code qui extrait le contenu d’un fichier externe dans une page Web. Voici un exemple d’instruction PHP d’inclusion :

<?php include('pageBanner.php'); ?>

Il existe deux fonctions d’inclusion de base en PHP : include() et require(). Les deux se comportent de la même manière mais retournent des erreurs différentes. Si une fonction include() n’est pas analysée correctement, elle continue le traitement du reste de la page et affiche un avertissement dans la page où le fichier inclus doit apparaître. Si une fonction require() fait référence à un fichier manquant, la fonction arrête le traitement de la page et affiche une page d’erreur dans le navigateur. Pour plus d’informations sur les fonctions include() et require(), voir PHP Include Files sur le site W3 Schools.

Les fonctions include_once() et require_once() spécifient qu’un fichier d’inclusion ne doit être utilisé qu’une seule fois dans une page. Si deux fonctions include() font référence au même fichier d’inclusion, seule la première fonction include() s’affiche dans le navigateur. Pour plus d’informations, voir include_once et require_once sur le site PHP.NET.

Microsoft Expression Web prend en charge l’utilisation de quatre types de fichiers différents en tant que fichiers d’inclusion : fichiers HTML, INC, PHP et TXT. En outre, vous pouvez également créer des fichiers d’inclusion imbriqués. Par exemple, vous pouvez créer un fichier d’inclusion qui contient une référence à un autre fichier d’inclusion.

Pour insérer une fonction include() dans une page Web

  1. Dans le menu Insertion, cliquez sur PHP, puis sur l’une des fonctions include() suivantes :

    • Include inclut le fichier chaque fois qu’il est référencé dans la page.

    • Include_once inclut le fichier la première fois qu’il est référencé dans la page.

    • Require requiert que le fichier soit traité avant que la page ne soit retournée, et inclut le fichier chaque fois qu’il est référencé dans la page.

    • Require_once requiert que le fichier soit traité avant que la page ne soit retournée, et inclut le fichier la première fois qu’il est référencé dans la page.

  2. Dans la boîte de dialogue Sélectionner une page PHP, sélectionnez le fichier que vous souhaitez inclure, puis cliquez sur Ouvrir.

Voir aussi

Tâches

Modifier la couleur du code PHP

Créer une page PHP

Insérer un script PHP

Aperçu d'une page PHP

Afficher ou masquer les marques de mise en forme PHP en mode Création

Création PHP à l’aide d’IntelliSense

Définir des options IntelliSense pour PHP

Concepts

Utilisation de sites PHP

Utilisation d'IntelliSense avec PHP