Fonction include_once

La fonction include_once inclut le fichier spécifié dans le script PHP courant, mais seulement s'il n'a pas été inclus auparavant. Ceci est particulièrement utile lors de travaux avec des fichiers contenant des déclarations de fonctions ou de classes, pour éviter des erreurs de redéclaration. Le chemin vers le fichier à inclure est passé en paramètre de la fonction.

Syntaxe

phpinclude_once 'path/to/file.php';

Exemple

Incluons le fichier config.php une seule fois :

php<?php
  include_once 'config.php';
  include_once 'config.php'; // Cet appel sera ignoré
?>

Exemple

Tentative d'inclure un fichier inexistant :

php<?php
  include_once 'nonexistent.php'; // Générera un avertissement, mais n'arrêtera pas l'exécution du script
  echo 'Le script continue...';
?>

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

phpWarning: include_once(nonexistent.php): failed to open stream: No such file or directory
Le script continue...

Exemple

Utilisation d'une variable pour spécifier le chemin :

php<?php
  $filePath = 'lib/functions.php';
  include_once $filePath;
?>

Voir aussi