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

include_once 'path/to/file.php';

Exemple

Incluons le fichier config.php une seule fois :

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

Exemple

Tentative d'inclure un fichier inexistant :

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

Warning: 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
	$filePath = 'lib/functions.php';
	include_once $filePath;
?>

Voir aussi

la fonction include,
qui inclut un fichier sans vérification d'inclusion répétée
la fonction require,
qui inclut un fichier avec arrêt du script en cas d'erreur
la fonction require_once,
qui fonctionne comme include_once, mais arrête le script en cas d'erreur