4.7.14 include

La fonction include inclus et évalue le fichier spécifié en argument.

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 .

Cela se produit à chaque fois que la fonction include est rencontrée. Donc, vous pouvez utiliser la fonction include dans une boucle pour inclure un nombre infini de fois un fichier, ou même des fichiers différents.

<?php $files = array ('premier.inc', 'second.inc', 'troisieme.inc'); for ($i = 0; $i < count($files); $i++) {     include $files[$i]; } ?>

include diffère de require car le fichier inclus est ré-évaluée à chaque fois que la commande est exécutée, tandis que require est remplacée par le fichier cible lors de la première exécution, que son contenu soit utilisé ou non. De plus, cela se fait même s'il est placé dans une structure conditionnelle, comme dans un if ).

Parceque la fonction include nécessite une construction particulière, vous devez l'inclure dans un bloc si elle est incluse dans une structure conditionnelle.

<?php /*  Ceci est faux, et ne fonctionnera pas comme on l'attend. */ if ($condition)     include($file); else     include($other); /* Ceci est CORRECT. */ if ($condition) {     include($file); } else {     include($other); } ?>

En PHP 3, il est possible d'exécuter une commande return depuis un fichier inclus, tant que cette commande intervient au niveau global du fichier inclus. Elle ne doit intervenir dans aucun bloc (entre accolade {}). En PHP 4, cette possibilité a été supprimée. Cependant, PHP 4 vous autorise à retourner des valeurs d'un fichier inclus. Vous pouvez traiter include comme une fonction normale, qui retourne une valeur. Mais cela génère une erreur d'analyse en PHP 3.

<?php
echo "Avant le retour<br>\n";
if (1) {
    return 27;
}
echo "Après le retour <br>\n";
?>

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 .

<?php   include ("file.inc?varone=1&vartwo=2"); /* ne fonctionne pas. */   $varone = 1;   $vartwo = 2;   include ("file.inc");     /* $varone et $vartwo sont accessibles dans file.inc */ ?>

Ne vous laissez pas abuser par le fait que vous pouvez requérir ou inclure des fichiers via HTTP en utilisant la fonctionnalité de gestion des fichiers distants ce qui est au dessus reste vrai.

Voir aussi readfile , require et virtual .