declare
<<<		 require include
>>>
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
->require
. include
. require_once
. include_once

4.7.13 require

La commande require se remplace elle-même par le contenu du fichier spécifié, comme les préprocesseurs C le font avec la commande #include .

Il est important de noter que lorsqu'un fichier est include ou require , les erreurs d'analyse apparaîtront en HTML tout au début du fichier, et l'analyse du fichier parent ne sera pas interrompue. Pour cette raison, le code qui est dans le fichier doit être placé entre les balises habituelles de PHP .

require n'est pas vraiment une fonction PHP : c'est plus une instruction du langage. Elle ne fonctionne pas comme les fonctions standards. Par exemple, require est indépendante des structures de contrôle (cela ne sert à rien de la placer dans une condition, elle sera toujours exécutée). De plus, elle ne retourne aucune valeur. Lire une valeur retournée par un require retourne une erreur d'analyse.

Contrairement à include , require va toujours lire dans le fichier cible, même si la ligne n'est jamais exécutée. Si vous souhaitez une inclusion conditionnelle, utilisez include . La condition ne va jamais affecter require . Cependant, si la ligne de require n'est jamais exécutée, le code du fichier ne le sera jamais non plus.

Les boucles n'affectent pas le comportement de require . Même si le code contenu dans le fichier source est appelé dans la boucle, require n'est exécuté qu'une fois.

Cela signifie qu'on ne peut pas mettre un require dans une boucle, et s'attendre à ce qu'il inclue du code à chaque itération. Pour cela, il faut utiliser include . 

<?php
  require('header.inc');
?>

Attention : include et require ajoutent le contenu du fichier cible dans le script lui-même. Elles n'utilisent pas le protocole HTTP ou tout autre protocole. Toute variable qui est dans le champs du script sera accessible dans le fichier d'inclusion, et vice-versa. 

<?php
  require ("file.inc?varone=1&vartwo=2");
/* Ne fonctionne pas. */
  $varone = 1;
  $vartwo = 2;
  require ("file.inc");
/* $varone et $vartwo seront accessibles à file.inc */
?>

Voyez la documentation de la fonction include pour plus d'exemples.

Note

Avant PHP 4.0.2, ceci s'appliquait : require tentait de lire le fichier cible, même si les lignes n'étaient pas utilisées. Une condition if n'avait aucun effet sur require . Cependant, si la ligne du require n'est jamais utilisée, le code inclus ne le sera pas non plus. De même, les boucles n'ont pas d'effet sur le comportement de require . Bien que le code contenu dans le fichier subit la boucle, la fonction elle même require n'est appelée qu'une fois.

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 include , require_once , include_once , eval , file , readfile , virtual et include_path .

<< require >>
declare Les structures de contrôle include