Comprendre les différences entre include, require, include_once et require_once en PHP

Lorsque vous travaillez avec PHP, l'une des tâches courantes que vous rencontrerez consiste à inclure des fichiers externes dans vos scripts. PHP fournit plusieurs mécanismes pour cette tâche, à savoir include, require, include_once et require_once. Ces instructions sont essentielles pour modulariser le code et permettre la réutilisation des fichiers dans différentes parties d'une application. Cependant, comprendre les différences entre ces commandes est crucial pour écrire du code PHP efficace et maintenable.

Cet article vous guidera à travers chacune de ces déclarations, expliquera leur comportement, mettra en évidence leurs différences et fournira des cas d'utilisation pratiques.

---

1. La déclaration d'inclusion

Qu'est-ce que l'inclusion ?

L'instruction include en PHP est utilisée pour inclure et évaluer le fichier spécifié lors de l'exécution du script. Si le fichier est trouvé, il est inclus une fois et exécuté à ce stade du script.

Comportement de l'inclusion :

• Si le fichier spécifié n'est pas trouvé, PHP émet un avertissement (E_WARNING) mais continue l'exécution du script.
• Le message d'avertissement inclura le chemin du fichier introuvable.
• Cela n'arrête pas l'exécution du script, donc si le fichier inclus n'est pas critique, le script peut continuer à s'exécuter sans interruption.

Cas d'utilisation de include :

Vous pouvez utiliser include lorsqu'un fichier n'est pas critique pour le déroulement du programme et qu'il est acceptable de continuer le script même si le fichier est manquant. Ceci est souvent utilisé pour les fichiers non essentiels tels que les modèles facultatifs, les fichiers de configuration ou les mécanismes de journalisation.

Exemple :

// Including a non-critical file
include 'header.php';  // This will continue if header.php is missing
echo "This part of the script will run regardless of the missing header file.";

Pourquoi utiliser include ?

• Utile pour inclure des fichiers facultatifs tels que des modèles de page ou des configurations non essentielles.
• Permet au script de continuer à fonctionner même si le fichier ne peut pas être inclus.

---

2. La déclaration require

Qu'est-ce qui est requis ?

Comme include, l'instruction require est utilisée pour inclure et évaluer un fichier en PHP. Cependant, la différence majeure réside dans la manière dont les erreurs sont traitées.

Comportement de require :

• Si le fichier est introuvable ou ne peut pas être inclus, PHP émettra une erreur fatale (E_COMPILE_ERROR) et le script arrêtera immédiatement l'exécution.
• Contrairement à l'inclusion, le fichier manquant arrêtera le script s'il est critique.

Cas d'utilisation de require :

Vous devez utiliser require lorsque le fichier inclus est essentiel pour la fonctionnalité de l'application. Par exemple, un fichier de configuration qui définit des constantes ou inclut des fonctions importantes pour votre application doit être inclus avec require. Si le fichier est manquant, la poursuite de l'exécution pourrait entraîner un comportement imprévisible ou un échec.

Exemple :

// Including a non-critical file
include 'header.php';  // This will continue if header.php is missing
echo "This part of the script will run regardless of the missing header file.";

Pourquoi utiliser require ?

• Lorsque le fichier inclus est essentiel au fonctionnement du script, comme les fichiers de configuration ou les scripts de connexion à une base de données.
• Vous voulez vous assurer que le script cesse de s'exécuter si le fichier est manquant, pour éviter des erreurs inattendues ou des plantages ultérieurs dans le script.

---

3. La déclaration include_once

Qu'est-ce que include_once ?

L'instruction include_once est similaire à l'instruction include, avec une différence clé : elle garantit que le fichier n'est inclus qu'une seule fois lors de l'exécution du script, quel que soit le nombre de fois que l'instruction include_once est appelée dans le code.

Comportement de include_once :

• Il tentera d'inclure le fichier comme include.
• Si le fichier a déjà été inclus auparavant dans le script actuel, il ne l'inclura pas à nouveau.
• Si le fichier est introuvable, il émettra un avertissement, tout comme include, mais le script continue de s'exécuter.

Cas d'utilisation de include_once :

Vous utiliserez généralement include_once pour inclure des fichiers pouvant contenir des fonctions ou des définitions de classe qui ne doivent être incluses qu'une seule fois, quel que soit le nombre de fois que vous appelez l'inclusion. Par exemple, vous ne voudriez pas inclure un fichier qui définit une classe plusieurs fois, car cela pourrait entraîner des erreurs de redéfinition.

Exemple :

// Including a critical file
require 'config.php';  // This will stop the script if config.php is missing
echo "This will not run if config.php is not found.";

Pourquoi utiliser include_once ?

• Empêche l'inclusion d'un fichier plusieurs fois.
• Utile pour définir des fonctions, des classes ou des constantes dans un fichier qui ne doit être inclus qu'une seule fois, comme les fichiers utilitaires ou les fichiers de configuration.

---

4. La déclaration require_once

Qu'est-ce que require_once ?

L'instruction require_once fonctionne de la même manière que require, mais avec le comportement supplémentaire de garantir que le fichier n'est inclus qu'une seule fois lors de l'exécution du script.

Comportement de require_once :

• Il tentera d'inclure le fichier comme requis.
• Si le fichier a déjà été inclus, il ne l'inclura pas à nouveau, évitant ainsi les erreurs de redéfinition des classes, fonctions ou constantes.
• Si le fichier est manquant, cela provoquera une erreur fatale, tout comme require, interrompant l'exécution du script.

Cas d'utilisation de require_once :

Vous devez utiliser require_once lorsque vous incluez des fichiers essentiels qui ne doivent être inclus qu'une seule fois, tels que les fichiers de connexion à la base de données, les fichiers de configuration ou les définitions de classe. Il s'agit du moyen le plus robuste et le plus sécurisé de garantir que les fichiers critiques ne sont inclus qu'une seule fois sans risque de redéfinition.

Exemple :

// Including a non-critical file
include 'header.php';  // This will continue if header.php is missing
echo "This part of the script will run regardless of the missing header file.";

Pourquoi utiliser require_once ?

• Lorsque vous devez inclure des fichiers critiques pour le script et vous assurer qu'ils ne sont inclus qu'une seule fois, tels que des fichiers de configuration ou des définitions de classe.
• Empêche les erreurs de redéfinition en garantissant que le fichier n'est pas inclus plusieurs fois.

---

Comparaison de include, require, include_once et require_once

Statement	Behavior if File is Missing	Includes Only Once	Error Type
include	Warning, continues script	No	Warning (E_WARNING)
require	Fatal error, halts script	No	Fatal error (E_COMPILE_ERROR)
include_once	Warning, continues script	Yes	Warning (E_WARNING)
require_once	Fatal error, halts script	Yes	Fatal error (E_COMPILE_ERROR)

Principaux points à retenir :

• include : à utiliser lorsque le fichier est facultatif et que les fichiers manquants ne doivent pas interrompre le script.
• require : à utiliser lorsque le fichier est critique et le script doit s'arrêter si le fichier est manquant.
• include_once : à utiliser lorsque le fichier est facultatif mais ne doit être inclus qu'une seule fois pour éviter la duplication.
• require_once : à utiliser lorsque le fichier est critique et ne doit être inclus qu'une seule fois.

---

Conclusion

Le choix de la bonne déclaration d'inclusion dépend de la nature du fichier que vous incluez et du comportement que vous souhaitez appliquer. require et require_once sont généralement utilisés pour les fichiers essentiels, tandis que include et include_once conviennent mieux aux fichiers non critiques. L'utilisation de versions uniques de ces instructions permet d'éviter des problèmes tels que des erreurs de redéfinition en cas d'inclusions multiples.

En comprenant ces différences, vous pouvez écrire du code PHP plus fiable, modulaire et sans erreur, garantissant ainsi que votre application fonctionne correctement même lorsqu'il s'agit de fichiers manquants ou dupliqués.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!