设置include和require的目录get_include_path与set_include_path

首先 
我们来看这个全局变量：__FILE__ 
它表示文件的完整路径（当然包括文件名在内） 
也就是说它根据你文件所在的目录不同，有着不同的值；当然，当它用在包行文件中的时候，它的值是包含的路径； 



然后： 
我们看这个函数： 
string dirname ( string path ) 
它是PHP内置函数，它的作用是什么呢，就是返回除了本文件名以外的所在目录，给你举个例子 
假如你的首页中用到了_FILE_这个变量： 
（假设你的网页所在目录为：）,那么： 
_FILE_的值为（一个绝对路径）。而此时dirname (_FILE_)表示的就是也就是没有index.php这个文件名。 
而dirname(dirname(_FILE_))表示的就是上一级的目录，以此类推； 

最后 
看一下define()这个函数，其实他就是一个定义常量的函数，比如：define('MEN','ooooo'); 
那么你后你就可以用MEN来表示ooooo这个字符串； 
如果你学过C语言，你就很清楚,其中也有一个类似的#define MEN "ooooo";（其实应该说哦php和C类似，因为php就是c编写的）； 
那么这么写有什么好处呢，那就是当你需要修改变量的时候，你只要修改它就行了，相当的方便，尤其是像路径这样的字符串！ 


酒后给你解释一下你这段代码： 
define('__TYPECHO_ROOT_DIR__', dirname(__FILE__)); 
就是定义__TYPECHO_ROOT_DIR__为这个文件所在的目录，像这种定义一般是放在config.inc.php中的，那么获取的目录也就是config.inc.php所在的目录；也就是根目录！ 

define('__TYPECHO_PLUGIN_DIR__', '/usr/plugins'); 这就不要我说了吧！ 


至于set_include_path(get_include_path() . PATH_SEPARATOR . $path);是什么意思，我想没有你想得那么复杂：他就是包含路径； 

比如你有一个文件夹：命名为include，里面有 
数据库连接文件：conn.php……, 
你这样设置：set_include_path("/include") 
那么以后你就直接可以在其他页面中使用 
include("conn.php") 
这不是经常见到吗？它参数就字符串，当然你也可以设置多个路径，中间用;分开，

而你那句：
set_include_path(get_include_path() . PATH_SEPARATOR . 
__TYPECHO_ROOT_DIR__ . '/var' . PATH_SEPARATOR . 
__TYPECHO_ROOT_DIR__ . __TYPECHO_PLUGIN_DIR__); 
什意思呢，举个例子：
你的一个页面有这样的语句：
include('/inc/sql.php');
include('/inc/conn.php');
;
;
而你突然发现我把这些要包含的文件放在inc目录下不安全，怎么办，要改，我想放到include目录中，好的，这么多页面不累死才怪：有没有好的方法！有！！！！！！！

我在config.inc.php中写着么一句：
set_include_path(get_include_path() .'/include')就这么简单，对，就这么简单！动态的修改！


 

你不要看这个：get_include_path() . PATH_SEPARATOR . $path这是什么，他就一路径字符串，中间的.是字符串连接符号，也就是你刚才定义的那些常量的组合，组合成一字符串,我想你一定时认为是没见过的参数！ 
一个很简单的函数，没什么多的解释! 
也好就是说他可以动态的设置包含路径！如果正确返回包含路径，不正确返回false; 
//
功能同下面的一样，可以设置php包含目录：
在php的配置文件php.ini里有这么一行：
windows下路径：c:/windows/php.ini
linux下依据php安装目录不同而已，可以使用locate php.ini查找
include_path = ".;“
可以设置为：
include_path = ".:/web/common:/web/smarty:/web/include“
设置完成后，你在文件里包含这三个目录下的文件，直接写文件名即可，不需要写完整路径。
如：
include('/web/common/config.inc.php');可以直接写成：
include('config.inc.php')，即可，
注：include_path指令中，第一个是点，代表当前目录，多个目录的分隔：
windows下用分号
linux下用冒号

建议再查下php手册：

get_include_path（函数名称）
(PHP 4 >= 4.3.0, PHP 5)（加入版本）
get_include_path — Gets the current include_path configuration option（获取当前include_path的配置项）
string get_include_path ( void ) （返回值String 用法） 
//
在大型的Web项目中, include_path是一个模块化设计的根本中的根本(当然,现在也有很多基于autoload的设计, 这个不影响本文的探讨), 但是正是因为include_path, 经常会让我们遇到一些因为没有找到正确的文件而导致的看似”诡异”的问题.

也就有了如下的疑问:
include_path是怎么起作用的?
如果有多个include_path顺序是怎么样的?
什么情况下include_path不起作用?
今天, 我就全面的介绍下这个问题, 先从一个例子开始吧.
如下的目录结构:
  
  
  root
    ├ 1.php
    ├ 3.php
    └ subdir
         ├ 2.php
          └ 3.ph
在1.php中:
  
  
<?php
ini_set(“include_path”, “.:path_to_subdir”);
require(“2.php”);
?></SPAN
而在2.php中:
  
  
<?php
require(“3.php”);
?></SPAN
而在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”);
?></SPAN
那么将会是current_script_dir起作用, 而这个时候current_script_dir是2.php的路径, 所以还是会得到”subdir”的输出.
目录相对路径
在使用目录相对路径的情况下, 相对路径的基点, 永远都是当前工作目录.
为了说明在目录相对路径下的情况,我们再看个列子, 还是上面的目录结构, 只不过1.php变成了:
  
  
<?php
ini_set(“include_path”, “/”);
require(“./subdir/2.php”);
?></SPAN
2.php变成了:
  
  
<?php
require(“./3.php”);
?></SPAN
如果在root目录下执行, 2.php中寻找3.php将会在当前目录的相对路径下寻找, 所以得到的输出是”root”, 而如果是在subdir下执行上一级目录的1.php(php -f ../1.php), 将会因为在subdir下找不到”./subdir/2.php”而异常退出.
后记
1. 因为使用include_path和相对路径的情况下, 性能会和寻找的次数有关, 最坏的情况下, 如果你有10个include_path, 那么最多可能会重试11次才能找到要包含的文件, 所以, 在能使用绝对路径的情况下最好使用绝对路径.
2. 因为目录相对路径的basedir, 永远都是当前工作路径, 如果要使用, 需要和实际部署路径相关, 所以实际使用的很少(当然, 也有借助chdir来完成的模块).
3. 在模块化的系统设计中, 一般应该在模块内, 通过获取模块的部署路径(dirname(__FILE__), php5.3以后更是提供了__DIR__常量)从而使用绝对路径.