php require与include路径包含方法总结

发布时间:2019-10-02编辑:脚本学堂
有关php中包含路径函数include与require的用法,尤其是相对路径与绝对路径在这二个函数中的用法,多个实例供大家学习参考。

php编程中,引入外部文件或类库,一般会使用includerequire来完成,更多时候需要理解include与require的区别,今天这篇文章,可以带你深入理解require与include的用法,一起来看看吧。
 
1、绝对路径相对路径和未确定路径

相对路径
相对路径指以.开头的路径,例如
./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(...)设置)中去查找该文件。

测试环境说明
注意:下面的讨论和结论基于这样的环境: 假设 A=http://www.xxx.com/app/test/a.php,再次强调下面的讨论是针对直接访问A的情况。

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

例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

例2
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

例3
A中定义 require '../b.php'; //则B=[SITE]/app/b.php
B中定义 require '../c.php'; //则C=[SITE]/app/c.php 不是 [SITE]/c.php

例4:
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

例5
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

例6
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

3. 绝对路径
绝对路径的比较简单,不容易混淆出错,require|inclue 的就是对应磁盘中的文件。
 

复制代码 代码示例:
require '/wwwroot/xxx.com/app/test/b.php'; // linux
require 'c:/wwwroot/xxx.com/app/test/b.php'; // windows中


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

例1
A中定义 require '../b.php'; // 则B=[SITE]/app/b.php
B中定义 require dirname(__FILE__).'/c.php'; // 则B=[SITE]/app/c.php

例2
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文件;

4. 未确定路径
首先,在逐一用include_path中定义的包含目录来拼接[未确定路径],找到存在的文件则包含成功退出,如果没有找到,则用执行 require语句的php文件所在目录来拼接[未确定路径]组成的全路径去查找该文件,如果文件存在则包含成功退出,否则表示包含文件不存在,出错。 未确定路径比较容易搞混不建议使用。

5. 解决方案
由于“相对路径”中的“参照目录”是执行入口文件所在目录,“未确定”路径也比较容易混淆。

最好的解决方法:
使用“绝对路径”; 例如b.php的内容如下,无论在哪里require b.php都是以b.php的路径为参照来require c.php的
 

复制代码 代码示例:
$dir = dirname(__FILE__);
require($dir . '../c.php');
 

或定义一个通用函数 import.php,将其设置为“自动提前引入文件”,在php.ini做如下配置
更改配置项(必须)auto_prepend_file = "C:xampphtdocsauto_prepend_file.php"
更改配置项(可选)allow_url_include = On

import.php内容:
 

复制代码 代码示例:
function import($path) {
$old_dir = getcwd(); // 保存原“参照目录”
chdir(dirname(__FILE__)); // 将“参照目录”更改为当前脚本的绝对路径
require_once($path);
chdir($old_dir); // 改回原“参照目录”
}
 

可以使用import()函数来require文件,无论包含多少级“参照目录”都是当前文件。