require()

require() inclut et exécute un fichier PHP.

La commande require() se remplace elle-même par le contenu du fichier spécifié, tel que décrit dans la documentation de la fonction include() .

require() et include() sont identiques, sauf dans leur façon de gérer les erreurs. Ils produisent tous les deux une Alerte mais require() génère une erreur fatale . En d'autres termes, n'hésitez pas à utiliser require() si vous voulez qu'un fichier d'inclusion manquant interrompe votre script. include() ne se comporte pas de cette façon, et le script continuera son exécution. Assurez-vous d'avoir bien configuré le include_path aussi.

Exemple 16.32. Exemples avec require()

<?php

require  'prepend.php' ;

require 
$un_fichier ;

require (
'un_fichier.txt' );

?>

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.

Note: Comme ceci est une structure du langage, et non pas une fonction, il n'est pas possible de l'appeler avec les variables fonctions .

AVERTISSEMENT

Les versions Windows de PHP antérieures à la version 4.3.0 ne supportent 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() , get_included_files() , eval() , file() , readfile() , virtual() et include_path .