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

phprequire_once 'chemin/vers/fichier.php';

Exemple

Incluons le fichier config.php :

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) :

php'My Site'

Exemple

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

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

php5

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