【PHP】include详解

  作者:zhanhailiang 日期:2013-04-02

include加载文件顺序

寻找包含文件的顺序是：

1. 首先在当前 工作目录的相对的 include_path 下寻找，
2. 然后是当前 运行脚本所在目录相对的 include_path 下寻找。

例如 include_path 是 .，当前工作目录是 /includetest/，脚本中要 include 一个 includetest/a.php 并且在该文件中有一句 include “b.php”，则寻找 b.php 的顺序先是 /includetest/，然后是 /includetest/include/。如果文件名以 ./ 或者 ../ 开始，则只在当前工作目录相对的 include_path 下寻找。

代码结构如下：

~/public_html/includetest> ls -R
.:
a.php  b.php  include
 
./include:
a.php  b.php

其中各文件代码为：

~/public_html/includetest> cat a.php 
<?php
 
set_include_path(".");
include "include/a.php";
 
echo __FILE__ . PHP_EOL;
~/public_html/includetest> cat b.php 
<?php
 
echo __FILE__ . PHP_EOL;
~/public_html/includetest> cat include/a.php 
<?php
 
include "b.php";
echo __FILE__ . PHP_EOL;
~/public_html/includetest> cat include/b.php 
<?php
 
echo __FILE__ . PHP_EOL;

输出结果为：

~/public_html/includetest> php a.php
# 可以看到include/a.php中include "b.php";会先加载includetest/b.php文件
/home/zhanhailiang/public_html/includetest/b.php
/home/zhanhailiang/public_html/includetest/include/a.php
/home/zhanhailiang/public_html/includetest/a.php

注意：工作目录与运行脚本所在目录的概念区别。

include变量作用域

当一个文件被包含时，其中所包含的代码继承了 include 所在行的变量范围。从该处开始，调用文件在该行处可用的任何变量在被调用的文件中也都可用。不过所有在包含文件中定义的函数和类都具有全局作用域。

代码如下：

~/public_html/includetest> cat c.php 
<?php
 
include "d.php";
echo $d.PHP_EOL;
e();
~/public_html/includetest> cat d.php 
<?php
 
$d = "hello world";
 
function e() {
    echo "hello world, e()".PHP_EOL;
}
~/public_html/includetest> php c.php 
hello world
hello world, e()

相应地，如果 include 出现于调用文件中的一个函数里，则被调用的文件中所包含的所有代码将表现得如同它们是在该函数内部定义的一样。所以它将遵循该函数的变量范围。 An exception to this rule are magic constants which are evaluated by the parser before the include occurs.

include代码执行

当一个文件被包含时，语法解析器在目标文件的开头脱离 PHP 模式并进入 HTML 模式，到文件结尾处恢复。由于此原因，目标文件中应被当作 PHP代码执行的任何代码都必须被包括在有效的 PHP 起始和结束标记之中。

include处理远程文件

如果“URL fopen wrappers”在 PHP 中被激活（默认配置），可以用 URL（通过 HTTP 或者其它支持的封装协议——所支持的协议见支持的协议和封装协议）而不是本地文件来指定要被包含的文件。如果目标服务器将目标文件作为 PHP 代码解释，则可以用适用于 HTTP GET 的 URL 请求字符串来向被包括的文件传递变量。严格的说这和包含一个文件并继承父文件的变量空间并不是一回事；该脚本文件实际上已经在远程服务器上运行了，而本地脚本则包括了其结果。

include处理返回值

处理返回值：可以在被包括的文件中使用 return 语句来终止该文件中程序的执行并返回调用它的脚本。同样也可以从被包含的文件中返回值。可以像普通函数一样获得 include 调用的返回值。不过这在包含远程文件时却不行，除非远程文件的输出具有合法的 PHP 开始和结束标记（如同任何本地文件一样）。可以在标记内定义所需的变量，该变量在文件被包含的位置之后就可用了。

因为 include 是一个特殊的语言结构，其参数不需要括号。在比较其返回值时要注意。

如果文件不能被包含，则返回 FALSE 并发出一个 E_WARNING 警告。

如果在包含文件中定义有函数，这些函数可以独立于是否在 return 之前还是之后在主文件中使用。如果文件被包含两次，PHP 5 发出致命错误因为函数已经被定义，但是 PHP 在 return 之后不会抱怨函数已定义。推荐使用 include_once 而不是检查文件是否已包含并在包含文件中有条件返回。

另一个将 PHP 文件“包含”到一个变量中的方法是用输出控制函数结合 include 来捕获其输出。

整理自：include