Fonction require

La fonction require inclut et exécute le fichier spécifié dans le script courant. Contrairement à include, si le fichier est absent, elle provoque une erreur fatale et arrête l'exécution du script. Cette fonction est souvent utilisée pour inclure des fichiers importants contenant des fonctions, des classes ou des paramètres de configuration.

Syntaxe

phprequire 'chemin/vers/fichier.php';

Exemple

Inclusion d'un fichier de configuration :

php<?php
  require 'config.php';
  echo $db_host; // Variable provenant de config.php
?>

Si le fichier config.php existe, son contenu sera exécuté et les variables deviendront accessibles.

Exemple

Tentative d'inclure un fichier inexistant :

php<?php
  require 'fichier_inexistant.php';
  echo 'Cette ligne ne sera pas exécutée';
?>

Si le fichier fichier_inexistant.php n'existe pas, le script se terminera avec une erreur.

Différence entre require et include

La principale différence est que require provoque une erreur fatale si le fichier est absent, alors que include génère seulement un avertissement.

php<?php
  include 'fichier_optionnel.php'; // Le script continuera de s'exécuter
  require 'fichier_obligatoire.php'; // Le script s'arrêtera en cas d'erreur
?>

Voir aussi