PHP中你應該知道的require()文件包含的正確用法

 以前看一些PHP框架源碼的時候，很奇怪在文件包含的時候，會用dirname(__FILE__)來拼湊文件路徑，不知道這樣做有什麼好處，後來終於發現了其中的緣由。

我們來看一個簡單的例子：

有a，b，c三個php文件。a.php在網站根目錄，b.php在b文件夾下——b/b.php，c.php在c文件夾下——c/c.php。有些混亂？看圖就一目了然了：

a.php 和 b.php 都包含了 c.php，最後 c.php 包含了d文件夾下的一個php文件——d/d.php。

我們先來看a.php：

1 2 3 4 5 6 <?php $file_name = 'a.php'; echo "this is a.php"; echo "<hr>"; require('c/c.php'); ?>

很簡單的代碼，打印輸出後，包含了c/c.php，接著，我們需要看c/c.php：

1 2 3 4 5 6 <?php $c_file_name = 'c.php'; echo 'this is c.php, is required by ' . $file_name; echo "<hr>"; require('../d/d.php'); ?>

打印輸出 "this is c.php, is required by a.php"，$file_name是在a.php中定義的變量。在最後，包含了d.php。因為d文件夾在當前c.php文件的上一層，所以，按照常理，我們會理所當然的把路徑寫成 "../d/d.php"。但是很遺憾，會報錯。原因在於，在被包含的文件中如c.php，再去包含其他文件，路徑是相對於最外層的父文件來說的，也就是相對於a.php，可以理解為因為你被我包含了，所以你要以我為准。看起來很玄乎，原理其實很簡單：你可以把 require('c/c.php'); 看成是c/c.php文件裡的代碼，這樣我們的a.php看起來可以是這個樣子：

1 2 3 4 5 6 7 8 9 10 <?php $file_name = 'a.php'; echo "this is a.php"; echo "<hr>"; // require('c/c.php'); $c_file_name = 'c.php'; echo 'this is c.php, is required by ' . $file_name; echo "<hr>"; require('../d/d.php'); ?>

到此，你可以看到，我們要包含d/d.php文件時，剛才的路徑是不是錯誤的了？因為，現在是在a.php的代碼裡，我們是相對於a.php文件來說的，當然，路徑應該是 require('d/d.php'); 才對了。我們修改代碼如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 <?php $file_name = 'a.php';   echo "this is a.php"; echo "<hr>";   // require('c/c.php'); $c_file_name = 'c.php';   echo 'this is c.php, is required by ' . $file_name; echo "<hr>";   require('d/d.php'); ?>

此時，你還沒有領悟到深意，需要往下看，我們再看b/b.php：

1 2 3 4 5 6 7 <?php $file_name = 'b.php'; echo "this is b.php"; echo "<hr>";   require('../c/c.php'); ?>

不需要解釋了吧，沒啥問題，但是當你把 require('../c/c.php'); 換成 c/c.php 裡面的代碼的時候，你就會發現問題了，注意，我們剛才修改了c/c.php裡的代碼，把 require('../d/d.php'); 改成了 require('d/d.php'); 看下面包含進來後的代碼：

1 2 3 4 5 6 7 8 9 10 11 <?php $file_name = 'b.php'; echo "this is b.php"; echo "<hr>";   // require('../c/c.php'); $c_file_name = 'c.php'; echo 'this is c.php, is required by ' . $file_name; echo "<hr>"; require('d/d.php'); ?>

那麼，相對於 b/b.php 來說，require('d/d.php'); 的路徑錯了，應該是 require('../d/d.php'); 才對。你回去修改 c/c.php 中的require路徑，但是不對呀，你改了之後，b/b.php可以正常運行了，但是 a/a.php 又不行了，是不是，它們共用 c/c.php ，牽一發動全身，怎麼辦呢。

這個時候，我們回到文章開頭提到的 dirname(__FILE__)，這可是個好東西，可以完全解決以上問題。用了它，就可以不用關心包含你的文件是哪個文件、在哪個路徑下面了，不需要顧慮父文件所在的層級，因為，dirname(__FILE__)可以相對於當前文件指定路徑。也就是說，我們需要將我們的 c/c.php 中的 require 路徑換為：

1 2 3 4 5 6 7 8 <?php $c_file_name = 'c.php';   echo 'this is c.php, is required by ' . $file_name; echo "<hr>";   require(dirname(__FILE__) . '/../d/d.php'); ?>

這裡，我們只需要把 c/c.php 作為參照，相對於它來說，d/d.php 在上一層。這樣，就只有一個標准了，那就是，以我為准，管你包含我，還是他包含我，我只以我自己為准，我要包含的文件只相對於我自己而言了。

對於 dirname(__FILE__) 不明白的同修，請google，很簡單。

好了，PHP技術分享到此結束，有任何疑問或有錯誤之處，請留言。話說，這是我的第一個標准技術博文。第一篇是水文，第二篇是准技術，今天終於寫了篇技術的，歐也。