以前看一些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:
<?php $file_name = 'a.php'; echo "this is a.php"; echo "<hr>"; require('c/c.php'); ?>
很簡單的代碼,打印輸出後,包含了c/c.php,接著,我們需要看c/c.php:
<?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看起來可以是這個樣子:
<?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'); 才對了。我們修改代碼如下:
<?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:
<?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'); 看下面包含進來後的代碼:
<?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 路徑換為:
<?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技術分享到此結束,有任何疑問或有錯誤之處,請留言。話說,這是我的第一個標准技術博文。第一篇是水文,第二篇是准技術,今天終於寫了篇技術的,歐也。