深入理解PHP之require,include顺序详解

php教程 require/include顺序详解

也就有了如下的疑问:

在大型的web项目中, include_path是一个模块化设计的根本中的根本(当然,现在也有很多基于autoload的设计, 这个不影响本文的探讨), 但是正是因为include_path, 经常会让我们遇到一些因为没有找到正确的文件而导致的看似”诡异”的问题.也就有了如下的疑问:include_path是怎么起作用的?如果有多个include_path顺序是怎么样的?什么情况下include_path不起作用?今天, 我就全面的介绍下这个问题, 先从一个例子开始吧.如下的目录结构:  root     1.php              3.php                     subdir                             2.php                                  3.php在1.php中:
复制代码 代码如下:
<?php
ini_set("include_path", ".:path_to_subdir");
require("2.php");
?>而在2.php中:
复制代码 代码如下:
<?php
require("3.php");
?>而在root目录下的3.php打印出”root”, 在subdir目录下的3.php打印出”subdir”;现在, 我的问题来了:

include_path是怎么起作用的?

  1. 当在root目录下运行1.php, 会得到什么输出?
  2. 在subdir下运行上一级目录的1.php, 有会得到什么输出?
    3. 当取消include_path中的当前目录path(也就是include_path=”path_to_subdir”), 上面俩个问题又会是什么输出?
    php中的include_path
    php在遇到require(_once)/include(_once)的指令的时候, 首先会做如下的判断:
    复制代码 代码如下:
    要包含的文件路径是绝对路径么?
    如果是, 则直接包含, 并结束.
    如果不是, 进入另外的逻辑(经过多次调用, 宏展开后进入_php_stream_fopen_with_path)寻找此文件接下来, 在_php_stream_fopen_with_path中, 会做如下判断:
    复制代码 代码如下:
    要包含的文件路径是相对路径么(形如./file, ../dir/file, 以下用"目录相对路径代替")?
    如果是, 则跳过include_path的作用逻辑, 直接解析相对路径(随后单独介绍)会根据include_path,和当前执行文件的path组成一个待选的目录列表, 比如对于文章前面的例子来说, 会形成一个如下的待选列表
    复制代码 代码如下:
    ".:path_to_subdir:current_script_dir然后, 依次从待选列表头部开始, 根据default_dir_separator(本文的环境是”:”)取出待选列表中的一个路径, 然后把要包含的文件名附加在这个路径后面, 进行尝试. 如果成功包含, 则返回, 否则继续下一个待选路径.
    到现在为止, 我们已经可以回答我开头提出的3个问题了.
  3. 因为在root目录下执行, 所以在1.php中包含2.php的时候, include_path的第二个待选路径起了作用(path_to_subdir), 找到了path_to_subdir/2.php, 而在2.php包含3.php的时候, 当前工作目录是root下, 所以在包含3.php的时候, include_path的第一个待选路径”.”(当前工作目录)下就找到的匹配的文件, 所以得到的输出是”root”.
  4. 同1, 只不过当前的路径是subdir, 所以得到的输出是”subdir”.
  5. 因为没有了当前路径为include_path, 所以在root目录下运行的时候2.php中包含3.php的时候, 是path_to_subdir起了作用, 所以无论在root还是subdir都将得到”subdir”的输出.
    而如果在2.php中清空include_path,
    复制代码 代码如下:
    <?php
    ini_set("include_path", '');
    require("3.php");
    ?>那么将会是current_script_dir起作用, 而这个时候current_script_dir是2.php的路径, 所以还是会得到”subdir”的输出.
    目录相对路径
    在使用目录相对路径的情况下, 相对路径的基点, 永远都是当前工作目录.
    为了说明在目录相对路径下的情况,我们再看个列子, 还是上面的目录结构, 只不过1.php变成了:
    复制代码 代码如下:
    <?php
    ini_set("include_path", "/");
    require("./subdir/2.php");
    ?>2.php变成了:
    复制代码 代码如下:
    <?php
    require("./3.php");
    ?>如果在root目录下执行, 2.php中寻找3.php将会在当前目录的相对路径下寻找, 所以得到的输出是”root”, 而如果是在subdir下执行上一级目录的1.php(php -f ../1.php), 将会因为在subdir下找不到”./subdir/2.php”而异常退出.
    后记
  6. 因为使用include_path和相对路径的情况下, 性能会和寻找的次数有关, 最坏的情况下, 如果你有10个include_path, 那么最多可能会重试11次才能找到要包含的文件, 所以, 在能使用绝对路径的情况下最好使用绝对路径.
  7. 因为目录相对路径的basedir, 永远都是当前工作路径, 如果要使用, 需要和实际部署路径相关, 所以实际使用的很少(当然, 也有借助chdir来完成的模块).
  8. 在模块化的系统设计中, 一般应该在模块内, 通过获取模块的部署路径(dirname(__file__), php5.3以后更是提供了__dir__常量)从而使用绝对路径.

如果有多个include_path顺序是怎么样的?

什么情况下include_path不起作用?

今天, 我就全面的介绍下这个问题, 先从一个例子开始吧.

如下的目录结构:

  root    ├ 1.php    ├ 3.php    └ subdir         ├ 2.php          └ 3.php

在1.php中:

复制代码 代码如下:

<?php
ini_set("include_path", ".:path_to_subdir");
require("2.php");
?>

而在2.php中:

复制代码 代码如下:

<?php
require("3.php");
?>

而在root目录下的3.php打印出”root”, 在subdir目录下的3.php打印出”subdir”;

现在, 我的问题来了:

  1. 当在root目录下运行1.php, 会得到什么输出?
  2. 在subdir下运行上一级目录的1.php, 有会得到什么输出?
    3. 当取消include_path中的当前目录path(也就是include_path=”path_to_subdir”), 上面俩个问题又会是什么输出?
    PHP中的include_path PHP在遇到require(_once)/include(_once)的指令的时候, 首先会做如下的判断:

复制代码 代码如下:

要包含的文件路径是绝对路径么?
如果是, 则直接包含, 并结束.
如果不是, 进入另外的逻辑(经过多次调用, 宏展开后进入_php_stream_fopen_with_path)寻找此文件

接下来, 在_php_stream_fopen_with_path中, 会做如下判断:

复制代码 代码如下:

要包含的文件路径是相对路径么(形如./file, ../dir/file, 以下用"目录相对路径代替")?
如果是, 则跳过include_path的作用逻辑, 直接解析相对路径(随后单独介绍)

会根据include_path,和当前执行文件的path组成一个待选的目录列表, 比如对于文章前面的例子来说, 会形成一个如下的待选列表

复制代码 代码如下:

".:path_to_subdir:current_script_dir

然后, 依次从待选列表头部开始, 根据DEFAULT_DIR_SEPARATOR(本文的环境是”:”)取出待选列表中的一个路径, 然后把要包含的文件名附加在这个路径后面, 进行尝试. 如果成功包含, 则返回, 否则继续下一个待选路径.
到现在为止, 我们已经可以回答我开头提出的3个问题了.

  1. 因为在root目录下执行, 所以在1.php中包含2.php的时候, include_path的第二个待选路径起了作用(path_to_subdir), 找到了path_to_subdir/2.php, 而在2.php包含3.php的时候, 当前工作目录是root下, 所以在包含3.php的时候, include_path的第一个待选路径”.”(当前工作目录)下就找到的匹配的文件, 所以得到的输出是”root”.
  2. 同1, 只不过当前的路径是subdir, 所以得到的输出是”subdir”.
  3. 因为没有了当前路径为include_path, 所以在root目录下运行的时候2.php中包含3.php的时候, 是path_to_subdir起了作用, 所以无论在root还是subdir都将得到”subdir”的输出.
    而如果在2.php中清空include_path,

复制代码 代码如下:

<?php
ini_set("include_path", '');
require("3.php");
?>

那么将会是current_script_dir起作用, 而这个时候current_script_dir是2.php的路径, 所以还是会得到”subdir”的输出.
目录相对路径 在使用目录相对路径的情况下, 相对路径的基点, 永远都是当前工作目录.
为了说明在目录相对路径下的情况,我们再看个列子, 还是上面的目录结构, 只不过1.php变成了:

复制代码 代码如下:

<?php
ini_set("include_path", "/");
require("./subdir/2.php");
?>

2.php变成了:

复制代码 代码如下:

<?php
require("./3.php");
?>

如果在root目录下执行, 2.php中寻找3.php将会在当前目录的相对路径下寻找, 所以得到的输出是”root”, 而如果是在subdir下执行上一级目录的1.php(php -f ../1.php), 将会因为在subdir下找不到”./subdir/2.php”而异常退出.
后记 1. 因为使用include_path和相对路径的情况下, 性能会和寻找的次数有关, 最坏的情况下, 如果你有10个include_path, 那么最多可能会重试11次才能找到要包含的文件, 所以, 在能使用绝对路径的情况下最好使用绝对路径.

  1. 因为目录相对路径的basedir, 永远都是当前工作路径, 如果要使用, 需要和实际部署路径相关, 所以实际使用的很少(当然, 也有借助chdir来完成的模块).
  2. 在模块化的系统设计中, 一般应该在模块内, 通过获取模块的部署路径(dirname(__FILE__), php5.3以后更是提供了__DIR__常量)从而使用绝对路径.

您可能感兴趣的文章:

  • PHP中include()与require()的区别说明
  • PHP中require和include路径问题详解
  • PHP中include与require使用方法区别详解
  • PHP包含文件函数include、include_once、require、require_once区别总结
  • 从php核心代码分析require和include的区别
  • php include,include_once,require,require_once
  • PHP中include和require的区别实例分析

本文由365bet体育在线官网发布于关于计算机,转载请注明出处:深入理解PHP之require,include顺序详解

TAG标签:
Ctrl+D 将本页面保存为书签,全面了解最新资讯,方便快捷。