快捷導(dǎo)航

require(),include(),require_once()和include_once()區(qū)別

更新時間：2008年03月27日 23:02:34 作者：

面試中最容易提到的一個PHP的問題,我想和大家共勉一下: require()和include()有許多相似之處，也有些不同。理解它們的不同點非常重要，否則很容易犯錯誤。

我把這兩個語句放在一起介紹，讀者可以比較學(xué)習(xí)。
1.require()語句
require()語句用于指定的文件代替語句本身，就象C語言中的include()語句一樣。如果php配置文件php.ini中的URL fopen wrappers 是打開的(默認情況下是打開的)，就可以使用URL來指定文件的位置從而實現(xiàn)遠程文件的調(diào)用。
有一點就是使用require()和include()語句時要特別的注意。那就是在被包含的文件中，處理器是按照html模式來解釋其中的內(nèi)容的，處理完被包含的內(nèi)容后又恢復(fù)到php模式。所以如果需要在被包含文件中使用php語法，就要使用正確的php開始和結(jié)束標記來把這些語句包含進去。
require()和include()知識php中的一種語言特性，而不是函數(shù)。它們和函數(shù)有許多不同的地方。
比如：require()所包含的文件中不能包含控制結(jié)構(gòu)，而且不能使用return這樣的語句。在require()所包含的文件中使用return語句會產(chǎn)生處理錯誤。
不象include()語句，require()語句會無條件地讀取它所包含的文件的內(nèi)容，而不管這些語句是否執(zhí)行。所以如果你想按照不同的條件包含不同的文件，就必須使用include()語句。當(dāng)然，如果require()所在位置的語句不被執(zhí)行，require()所包含的文件中的語句也不會被執(zhí)行。
require()不能在循環(huán)體中根據(jù)條件的不同而包含不同的文件。require()語句只會在第一次執(zhí)行時調(diào)用它所包含的文件中的內(nèi)容替換本身這條語句，當(dāng)再次被執(zhí)行時只能執(zhí)行第一次所包含的語句。但是include()語句可以在循環(huán)體中來包含不同的文件。
require()語句中的變量繼承require()語句所在位置的變量作用域。所有在require()語句的位置可以訪問的變量，在require()語句所包含的文件中都可以訪問。如果require()語句位于一個函數(shù)內(nèi)部，那么被包含文件內(nèi)的語句都相當(dāng)于定義在函數(shù)內(nèi)部。
require()語句在PHP程序執(zhí)行前就會將使用require引用的文件讀入，因此require通常放到程序的開始處。因此要特別注意一點，require語句有一點強，不管程序是否真的需要引用的文件，只要你使用require語句，它都會把他們包含進來！即使你是在條件控制語句中使用這個函數(shù)進行包含，那怕是那個條件不為真，引用文件也會被包含進來！形成了僵尸，在運行過程中這些僵尸是不起任何可見作用的，但是很明顯它會加重負擔(dān)，所以這一點要特別注意！如果使用require語句發(fā)生了包含錯誤，那么程序?qū)⑤敵龀鲥e信息并停止運行??！

如果require()語句通過聲明文件的URL來包含遠程文件，而且遠程服務(wù)器按照php代碼來解釋該文件的話，本地php文件中所包含的內(nèi)容是在遠程服務(wù)器上處理以后的結(jié)果。例如：

復(fù)制代碼代碼如下:

 
/* 
這個例子假設(shè)some_server服務(wù)器可以解釋.php文件，而不對.txt文件進行解釋。在遠程文件中 
需要變量$varfirst和$varsecond 
*/ 
/*不能正確執(zhí)行，遠程服務(wù)器不處理.txt文件*/ 
require("http://some_server/file.txt?varfirst=1&varsecond=2"); 

/*不正確，這樣只能在本地機上尋找file.php文件*/ 
require("file.php?varfirst=1&varsecond=2"); 

/*正確的語句*/ 
require("http://some_server/file.php?varfirst=1&varsecond=2"); 

$varfirst=1; 
$varsecond=2; 
require("file.txt"); /*正確的語句*/ 
require("file.php"); /*正確的語句*/ 

本來在php3.0中，require()所包含的文件可以使用return語句，但條件是return語句不能出現(xiàn)在{}內(nèi)部，而必須出現(xiàn)在被包含文件的全局范圍內(nèi)。在php4.0中已經(jīng)取消了require()的這個功能，但是仍然可以使用include()來實現(xiàn)。

2.include()語句
include()語句和require()語句有許多相同的地方。凡是在上邊require()語句中沒有明確說明不能適用于include()的部分外，require()語句的功能完全適用于include()語句。下邊介紹require()語句所沒有的include()語句的功能和特點。
include語句只有在被執(zhí)行時才會讀入要包含的文件。在錯誤處理方便，使用include語句，如果發(fā)生包含錯誤，程序?qū)⑻^include語句，雖然會顯示錯誤信息但是程序還是會繼續(xù)執(zhí)行！
php處理器會在每次遇到include()語句時，對它進行重新處理，所以可以根據(jù)不同情況的，在條件控制語句和循環(huán)語句中使用include()來包含不同的文件。
例如：

復(fù)制代碼代碼如下:

 
<?php 
$files=array('first.php','second.php','third.php'); 
for($i=0;$i<count($files);$i++) 
{ 
include $files[$i]; 
} 
?> 

在php3.0和php4.0中include()語句所包含的文件中都可以使用return語句來返回一個值，并停止執(zhí)行被包含文件下面的內(nèi)容。但php3.0和php4.0在處理這樣的情況時有所不同。在php3.0中return語句不能包含在{}內(nèi)，除非它在一個函數(shù)中，因為這時它表示函數(shù)的返回值而不是文件的返回值。而在php4.0中就沒有了這樣的限制，用戶甚至可以在文件中返回一個數(shù)字，就象函數(shù)的返回值一樣。這樣的語句在

php3.0中通常會報告錯誤。以下舉例說明：
假設(shè)被包含的文件為test.inc和主文件main.php位于一個目錄中。test.inc的內(nèi)容如下：
test.inc

復(fù)制代碼代碼如下:

 
<?php 
echo "Before the return<br>\n"; 
if(1) 
{ 
return 27; 
} 
echo "After the return<br>\n"; 
?> 

假設(shè)在main.php文件中包含下面的語句：

復(fù)制代碼代碼如下:

 
<?php 
$retval=include('test.inc'); 
echo "File returned:'$retval'<br>\n"; 
?> 

php3.0解釋器會在第二行報告錯誤，而不能得到include()語句的返回值。但在php4.0中會得到下面的結(jié)果：
Before the return
File returned: '27'
下邊假設(shè)main.php改為：

復(fù)制代碼代碼如下:

 
<?php 
include('test.inc'); 
echo "Back in main.html<br>\n"; 
?> 

在php4.0中的輸出結(jié)果是:
Before the return
Back in main.html

在php5.0中的輸出結(jié)果也是:
Before the return
Back in main.html

在php3.0中的輸出結(jié)果是:
Before the return
27Back in main.html

Parse error:parse error in /apache/htdocs/phptest/main.html on line 5

出現(xiàn)上面的錯誤是因為return語句位于{}內(nèi)部而且不是一個函數(shù)內(nèi)部。如果把{}去掉，使它位于test.inc的最外層，輸出結(jié)果是：
Before the return
27Back in main.html
之所以出現(xiàn)27，是因為在php3.0中不支持include()返回。

3.require_once()和include_once()語句
require_once()和include_once()語句分別對應(yīng)于require()和include()語句。require_once()和include_once()語句主要用于需要包含多個文件時，可以有效地避免把同一段代碼包含進去而出現(xiàn)函數(shù)或變量重復(fù)定義的錯誤。例如：如果創(chuàng)建兩個文件util.inc和fool.inc，程序代碼分別為：
util.inc:

復(fù)制代碼代碼如下:

 
<?php 
define(PHPVERSION,floor(phpversion())); 
echo "GLOBALS ARE NICE<br>\n"; 
function goodTea() 
{ 
return "Olong tea tasts good!"; 
} 
?> 

和fool.inc:

復(fù)制代碼代碼如下:

 
<?php 
require ("util.inc"); 
function showVar($var) 
{ 
if(PHPVERSION==4) 
{ 
print_r($var); 
} 
else 
{ 
var_dump($var); 
} 
} 
?> 

然后在error_require.php中包含這兩個文件：

復(fù)制代碼代碼如下:

 
<?php 
require("fool.inc"); 
require("util.inc");//此句會產(chǎn)生一個錯誤 
$foo=array("1",array("complex","quaternion")); 
echo "this is requiring util.inc again which is also<br>\n"; 
echo "required in fool.inc\n"; 
echo "Running goodTea:".goodTea()."<br>\n"; 
echo "Printing foo:<br>\n"; 
showVar($foo); 
?> 

當(dāng)運行error_require.php時，輸出結(jié)果如下：
GLOBALS ARE NICE
GLOBALS ARE NICE

Fatal error:Cannot redeclare goodTea() in util.inc on line 4

如果使用require_once()語句來代替 require()語句,就不會出現(xiàn)上面的錯誤。我們把error_require.php和fool.inc中的require()語句改為require_once()語句并重命名為error_require_once.php,這是顯示結(jié)果如下：
GLOBALS ARE NICE
this is requiring util.inc again which is also
required in fool.inc Running goodTea:Olong tea tastes good!
Printing foo:
Array([0] => 1 [1] => Array ([0] => complex [1] = quaternion))

include_once()語句的語法和include()語句類似，主要區(qū)別也是避免多次包含一個文件而引起函數(shù)或變量的重復(fù)定義。

require_once語句有一個引用鏈，它可以保證文件加入你的程序僅僅只有一次，而且會避開變量值和函數(shù)名之間的沖突。

和require_once語句一樣，include_once語句把include的功能擴展了。在程序執(zhí)行期間，將指定的文件包含進來，如果從文件引用進來的程序先前已經(jīng)包含過的時候，include_once()就不會把它再包含進來。也就是僅僅可以引用同一個文件一次！

include_once() 語句在腳本執(zhí)行期間包含并運行指定文件。此行為和 include() 語句類似，唯一區(qū)別是如果該文件中的代碼已經(jīng)被包含了，則不會再次包含。如同此語句名字暗示的那樣，只會包含一次。

include_once() 應(yīng)該用于在腳本執(zhí)行期間同一個文件有可能被包含超過一次的情況下，想確保它只被包含一次以避免函數(shù)重定義，變量重新賦值等問題。

使用 require_once() 和 include_once() 的更多例子見最新的 PHP 源程序發(fā)行包中的 PEAR 代碼。

返回值和 include() 相同。如果文件已被包含，本函數(shù)返回 TRUE。

注: include_once() 是 PHP 4.0.1pl2 中新加入的。

注: 要注意 include_once() 和 require_once() 在大小寫不敏感的操作系統(tǒng)中（例如 Windows）的行為

可能不是所期望的。
例子： include_once() 在 Windows 下不區(qū)分大小寫

復(fù)制代碼代碼如下:

 
<?php 
include_once("a.php"); // this will include a.php 
include_once("A.php"); // this will include a.php again on Windows! (PHP 4 only) 
?> 

此行為在 PHP 5 中改了，路徑先被規(guī)格化，因此 C:\PROGRA~1\A.php 和 C:\Program Files\a.php 的實現(xiàn)一樣，文件只會被包含一次。

如果要包含的文件不存在，include提示notice，然后繼續(xù)執(zhí)行下面的語句，require提示致命錯誤并且退出。

　　win32平臺下它們都是先包含后執(zhí)行，所以被包含文件里最好不要再有include或require語句，這樣會造成目錄混亂。或許Linux下情況不同，暫時還沒測試。

　　如果一個文件不想被包含多次可以使用include_once或require_once## 讀取，可以寫入文檔數(shù)據(jù)。

復(fù)制代碼代碼如下:

 
<?php 
function r($file_name) { 
　$filenum=@fopen($file_name,"r"); 
　@flock($filenum,LOCK_SH); 
　$file_data=@fread($filenum,filesize($file_name)); 
　@fclose($filenum); 
　return $file_data; 
} 
function w($file_name,$data,$method="w"){ 
　$filenum=@fopen($file_name,$method); 
　flock($filenum,LOCK_EX); 
　$file_data=fwrite($filenum,$data); 
　fclose($filenum); 
　return $file_data; 
} 