Maison > Article > développement back-end > Quelle est la fonction d'inclure en php
La fonction de include en php est d'inclure et d'exécuter le fichier spécifié. Le fichier inclus est d'abord recherché en fonction du chemin donné par le paramètre. Si aucun répertoire n'est donné, il est recherché en fonction du répertoire spécifié par include_path. de son utilisation sont tels que "include 'vars.php ';".
L'environnement d'exploitation de cet article : système Windows 7, PHP version 7.1, ordinateur Dell G3.
Quelle est la fonction d'include en php ?
include (PHP 4, PHP 5, PHP 7, PHP 8)
include expression inclut et exécute le fichier spécifié.
Les documents suivants s'appliquent également à require
.
Le fichier inclus est d'abord recherché en fonction du chemin donné par le paramètre. Si aucun répertoire n'est donné (uniquement le nom du fichier), il est recherché en fonction du répertoire spécifié par include_path. Si le fichier n'est pas trouvé sous include_path, include recherchera finalement dans le répertoire où se trouve le fichier de script appelant et dans le répertoire de travail actuel. La structure include émettra un E_WARNING si le fichier n'est pas trouvé à la fin ; ceci est différent de require, qui émettra un E_ERROR.
Notez que si le fichier est inaccessible, include et require émettront un E_WARNING supplémentaire avant d'émettre respectivement le E_WARNING ou E_ERROR final.
Si un chemin est défini - qu'il s'agisse d'un chemin absolu (commençant par une lettre de lecteur ou sous Windows, commençant par / sous Unix/Linux) ou d'un chemin relatif vers le répertoire courant (commençant par . ou ..) - include_path sera complètement ignoré. Par exemple, si un fichier commence par ../, l'analyseur recherchera le fichier dans le répertoire parent du répertoire courant.
Pour plus d'informations sur la façon dont PHP gère les fichiers d'inclusion et les chemins d'inclusion, consultez la documentation dans la section include_path.
Lorsqu'un fichier est inclus, le code qu'il contient hérite de la portée variable de la ligne d'inclusion. À partir de ce moment, toutes les variables disponibles dans le fichier appelant sur cette ligne sont également disponibles dans le fichier appelé. Cependant, toutes les fonctions et classes définies dans les fichiers include ont une portée globale.
Exemple #1 Exemple d'inclusion de base
vars.php
<?php $color = 'green'; $fruit = 'apple'; ?>
test.php
<?php echo "A $color $fruit"; // A include 'vars.php'; echo "A $color $fruit"; // A green apple ?>
Si une inclusion apparaît dans une fonction dans un fichier appelant, tout le code contenu dans le fichier appelé se comportera comme s'il avait été défini à l'intérieur de la fonction. Il suivra donc la portée variable de cette fonction. La seule exception à cette règle concerne les constantes magiques, qui sont traitées par l'analyseur avant que l'inclusion ne se produise.
Exemple n°2 Inclut dans les fonctions
<?php function foo() { global $color; include 'vars.php'; echo "A $color $fruit"; } /* vars.php 在 foo() 范围内,所以 $fruit 在范围为不可用。 * * $color 能用是因为声明成全局变量。 */ foo(); // A green apple echo "A $color $fruit"; // A green ?>
Lorsqu'un fichier est inclus, l'analyseur quitte le mode PHP au début du fichier cible et passe en mode HTML, et reprend à la fin du fichier. Pour cette raison, tout code d'un fichier objet qui doit être exécuté en tant que code PHP doit être inclus dans des balises de début et de fin PHP valides.
Si les "URL include wrappers" sont activés dans PHP, les fichiers à inclure peuvent être spécifiés à l'aide d'URL (via HTTP ou d'autres protocoles d'encapsulation pris en charge - voir Protocoles pris en charge et protocoles d'encapsulation) au lieu de fichiers locaux. Si le serveur cible interprète le fichier cible comme du code PHP, vous pouvez transmettre des variables au fichier inclus à l'aide de la chaîne de requête URL pour HTTP GET. Ce n'est pas strictement la même chose que de contenir un fichier et d'hériter de l'espace variable du fichier parent ; le fichier de script a en fait été exécuté sur le serveur distant et le script local inclut ses résultats.
Exemple n°3 : inclusion sur HTTP
<?php /* 这个示例假定 www.example.com 配置为解析 .php 文件而不解析 .txt 文件。 * * 此外 “Works” 意味着 $foo 和 $bar 变量在包含的文件中是可用的。 */ // 无法执行; file.txt 没有被 www.example.com 当作 PHP 处理。 include 'http://www.example.com/file.txt?foo=1&bar=2'; // 无法执行;在本地文件系统中查找名为 “file.php?foo=1&bar=2” 的文件。 include 'file.php?foo=1&bar=2'; // 正常。 include 'http://www.example.com/file.php?foo=1&bar=2'; ?>
AVERTISSEMENT
Les fichiers distants peuvent être traités par le serveur distant (en fonction du suffixe du fichier et si le serveur distant exécute PHP), mais doivent produire un script PHP valide comme il sera traité par le serveur local. Si un fichier d'un serveur distant doit être exécuté à distance et afficher uniquement les résultats, il est préférable d'utiliser la fonction readfile(). Faites également très attention à ce que les scripts distants produisent du code légal et requis.
Apprentissage recommandé : "Tutoriel vidéo PHP"
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!