4.7 Les structures de contrôle
4 Référence
Manuel PHP
. if . else . elseif . Syntaxe alternative . while . do..while . for . foreach . break . continue . switch . declare . return . require . include ->require_once . include_once
|
4.7.16 require_once
La commande
require_once
se remplace elle-même
par le fichier spécifié, un peu comme les commandes de
préprocesseur C
#include
, et ressemble sur
ce point à
require
. La principale
différence est qu'avec
require_once
,
vous êtes assurés que ce code ne sera ajouté
qu'une seule fois, évitant de ce fait les redéfinitions de
variables ou de fonctions, génératrices d'alertes.
require_once
doit être utilisée dans les cas
où le même fichier risque d'être inclus et évalué plusieurs fois
durant l'exécution d'un script. Vous serez alors sûrs qu'il ne sera inclut qu'une fois
et vous éviterez les problèmes de re-déclarations de fonctions ou autres.
Pour des exemples avec
require_once
et
include_once
, reportez-vous au code
PEAR inclus dans les
dernières distributions
PHP
.
Note |
Attention,
require_once
et
include_once
sont insensibles à la casse
sous Windows.
require_once est insensible à la casse sur Windows |
require_once("a.php"); // ceci inclut le fichier a.php require_once("A.php"); // ceci inclut encore le fichier a.php sous Windows!
|
|
Attention |
La version Windows de
PHP
ne supporte pas l'accès aux fichiers distants avec cette fonction, même si allow_url_fopen est activé.
|
Voir aussi
require
,
include
,
include_once
,
get_required_files
,
get_included_files
,
readfile
et
virtual
.
|