【转】 php中require注意事项

【转自】：http://blog.miaoheguang.tk/archives/11

 

被PHP的include路径弄晕了。自己试验一通，总结如下。

定义A=包含文件 B=被A包含的文件 C=被B包含的文件

也就是说 A 包含 B， B包含C

A中有

Php 代码

require ‘[B路径]‘ //(这里 的require可以换成require_once include)

require ‘[B路径]‘ //(这里的require可以换成require_once include)

B 中有

Php代码

require ‘[C路径]‘ //(这里 的require可以换成require_once include)

require ‘[C路径]‘ //(这里的require可以换成require_once include)

下面的讨论主要针对A为入口文件，即只直接访问A，不直接访问B。

首先定义两个概念：相对路径和全路径，我对它们的定义是，相对路径指以. 开头的路径，例如 ./a/a.php (相对当前目录) ../common.inc.php (相对上级目录)， 全路径是以/开头或者windows下的C:/类似的盘符开头的路径，全路径不用任何参考路径就可以唯一确定文件的最终地址。 例如 /apache/wwwroot/site/a/a.php c:/wwwroot/site/a/a.php

除了相对路径和全路径之外的路径还有其他类型的路径吗？ 还有。凡是不以.或者/开头、也不是windows下盘符:/开头的路径，例如 a/a.php common.inc.php，这样的路径，就是第三种 类型路径。开始以为这也是相对路径，但在php的include/require包含机制 中，这种类型的路径跟以.开头的相对路径处理是完全不同的。 （require ‘./a.php’ 和 require ‘a.php’ 是不同的！）我们姑且叫这种路径为未确定路径

下面分析这三种类型包含路径的处理方式：首先记住一个结论：如果包含路径为相对路径或者全路径，则不会到include_path中去查找该文 件，也就是说不管php.ini中定义的include_path环境变量是多少，或者在程序中设置set_include_path(…)为多少。

引用

If a path is defined (full or relative), the include_path will be ignored altogether.

注意：下面的讨论和结论基于这样的环境：

假设 A=[SITE]/app/test/main.php， 再次强调下面的讨论是针对直接访问A的情况。 ([SITE]代表站点的根目录，可以替换成成http://www.xxx.com这样的域名根路径或者文档存储的物理目录如： c:/wwwroot/xxx.com 或者 /usr/wwwroot/xxx.com )，请读者在自己能测试的网站根目录创建/app/test/ 目录，并在其中创建main.php，最好是把下面的例子都实践一下。

1. 相对路径：

相对路径需要一个参考目录才能确定文件的最终路径，在包含解析中，这个参考目录是程序执行入口文件所在目录，不管包含嵌套多少层。

如果

A中定义 require ‘./b/b.php’; //则B=[SITE]/app/test/b/b.php

B中定义 require ‘./c.php’; //则C=[SITE]/app/test/c.php 不是 [SITE]/app/test/b/c.php

如果

A中定义 require ‘./b/b.php’; //则B=[SITE]/app/test/b/b.php

B中定义 require ‘../c.php’; //则C=[SITE]/app/c.php 不是 [SITE]/app/test/c.php

如果

A中定义 require ‘../b.php’; //则B=[SITE]/app/b.php

B中定义 require ‘../c.php’; //则C=[SITE]/app/c.php 不是 [SITE]/c.php

如果

A中定义 require ‘../b.php’; //则B=[SITE]/app/b.php

B中定义 require ‘./c/c.php’; //则C=[SITE]/app/test/c/c.php 不是 [SITE]/app/c/c.php

如果

A中定义 require ‘../inc/b.php’; //则B=[SITE]/app/inc/b.php

B中定义 require ‘./c/c.php’; //则C还是=[SITE]/app/test/c/c.php 不是 [SITE]/app/inc/c/c.php

同理如果

A中定义 require ‘../inc/b.php’; //则B=[SITE]/app/inc/b.php

B中定义 require ‘./c.php’; //则C=[SITE]/app/test/c.php 不是 [SITE]/app/inc/c.php

2. 全路径：

全路径的比较简单，不容易混淆出错。举一个简单例子

A中定义 require ‘/wwwroot/xxx.com/app/test/b.php’; //则在windows下B=c:/wwwroot/xxx.com/app/test/b.php (c:为服务器所在盘符)，在linux下B=/wwwroot/xxx.com/app/test/b.php

dirname(__FILE__)计算出来的也是一个全路径形式的目录，但是要注意__FILE__是一个Magic constants，不管在什么时候都等于写这条语句 的php文件所在的全路径，因此 dirname(__FILE__)也总是指向写这条语句的php文件所在的全路径，跟这个文件是否被其他文件包含使用没有任何关系。

例如：

A中定义 require ‘../b.php’; //则B=[SITE]/app/b.php

B中定义 require dirname(__FILE__).’/c.php’; //则B=[SITE]/app/c.php

如果

A中定义 require ‘../inc/b.php’; //则B=[SITE]/app/inc/b.php

B中定义 require dirname(__FILE__).’/c.php’; //则B=[SITE]/app/inc/c.php 始终跟B在同一个目录

结论：不管B是被A包含使用，还是直接被访问，

B如果 require dirname(__FILE__).’/c.php’ ，则始终引用到跟B在同一个目录中的 c.php文件;

B如果 require dirname(__FILE__).’/../c.php’ ，则始终引用到B文件所在目录的父目录中的 c.php文件;

B如果 require dirname(__FILE__).’/c/c.php’ ，则始终引用到B文件所在目录的c子目录中的 c.php文件;

3. 除相对路径和全路径之外的未确定路径

首先在逐一用include_path中定义的包含目录来拼接[未确定路径]，找到存在的文件则包含成功退出，如果没有找到，则用写require语句的 php文件所在目录来拼接[未确定路径]组成的全路径去查找该文件，如果文件存在则 包含成功退出，否则表示包含文件不存在，出错。