(PHP 4, PHP 5, PHP 7)
La structure include_once inclut et
évalue le fichier spécifié durant l'exécution du script.
Le comportement est similaire à
include,
mais la différence est que si le code a déjà été inclus, il ne le sera pas une seconde fois, et include_once retourne TRUE. Comme son nom l'indique, le fichier sera inclut une seule fois.
La structure include_once est utilisée de préférence lorsque le fichier va être inclus ou évalué plusieurs fois dans un script, ou bien lorsque vous voulez être sûr qu'il ne sera inclus qu'une seule fois, pour éviter des redéfinitions de fonctions ou de classes.
Voyez la structure include pour plus de détails sur son fonctionnement.
Note:
En PHP 4, la fonctionnalité _once diffère avec les systèmes insensibles à la casse (comme Windows).
Exemple #1 include_once avec un OS insensible à la casse en PHP 4
<?php
include_once "a.php"; // ceci inclut le fichier a.php
include_once "A.php"; // ceci inclut encore le fichier a.php! (uniquement en PHP 4)
?>Ce comportement a changé en PHP 5 : le chemin est normalisé d'abord, donc, le fichier C:\PROGRA~1\A.php est reconnu comme étant identique au fichier C:\Program Files\a.php et le fichier ne sera inclus qu'une seule fois.