Fonction require_once

La fonction require_once inclut le fichier spécifié dans le script courant. Si le fichier a déjà été inclus auparavant, la fonction ne l'inclura pas à nouveau. Ceci est particulièrement utile pour inclure des fichiers contenant des classes ou des fonctions, où une inclusion répétée pourrait provoquer des erreurs.

Syntaxe

require_once 'chemin/vers/fichier.php';

Exemple

Incluons le fichier config.php :

<?php
	require_once 'config.php';
	echo $config['site_name'];
?>

Résultat de l'exécution du code (si le tableau $config est défini dans config.php) :

'My Site'

Exemple

Tentative de ré-inclusion du même fichier :

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Cet appel sera ignoré
	echo sum(2, 3);
?>

Résultat de l'exécution du code :

5

Différence avec require

Contrairement à require, la fonction require_once vérifie si le fichier a déjà été inclus et n'effectue pas une nouvelle inclusion. Cela empêche les erreurs lors de l'inclusion multiple du même fichier.

Voir aussi

la fonction include,
qui inclut également des fichiers, mais ne vérifie pas leur inclusion répétée
la fonction include_once,
qui fonctionne de manière similaire à require_once, mais ne provoque pas d'erreur fatale si le fichier est absent