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

require 'chemin/vers/fichier.php';

Exemple

Inclusion d'un fichier de configuration :

<?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
	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
	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

la fonction include,
qui inclut également des fichiers, mais n'arrête pas le script en cas d'erreur
la fonction require_once,
qui garantit l'inclusion unique d'un fichier