Include()
The include() 語(yǔ)句包括并運(yùn)行指定文件。
以下文檔也適用于require()。這兩種結(jié)構(gòu)除了在如何處理失敗之外完全一樣。include() 產(chǎn)生一個(gè)警告而require() 則導(dǎo)致一個(gè)致命錯(cuò)誤。換句話說(shuō)，如果你想在遇到丟失文件時(shí)停止處理頁(yè)面就用require()。include() 就不是這樣，腳本會(huì)繼續(xù)運(yùn)行。同時(shí)也要確認(rèn)設(shè)置了合適的include_path。
當(dāng)一個(gè)文件被包括時(shí)，其中所包含的代碼繼承了include 所在行的變量范圍。從該處開(kāi)始，調(diào)用文件在該行處可用的任何變量在被調(diào)用的文件中也都可用。
例子12-3. 基本的 include() 例子
vars.php
復(fù)制代碼 代碼如下:
<?php
$color = 'green';
$fruit = 'apple';
?>
test.php
復(fù)制代碼 代碼如下:
<?php
echo "A $color $fruit"; // A
include 'vars.php';
echo "A $color $fruit"; // A green apple
?>
如果include 出現(xiàn)于調(diào)用文件中的一個(gè)函數(shù)里，則被調(diào)用的文件中所包含的所有代碼將表現(xiàn)得如同它們是在該函數(shù)內(nèi)部定義的一樣。所以它將遵循該函數(shù)的變量范圍。
例子12-4. 函數(shù)中的包括
復(fù)制代碼 代碼如下:
<?php
function foo()
{
global $color;
include 'vars.php';
echo "A $color $fruit";
}
/* vars.php is in the scope of foo() so *
* $fruit is NOT available outside of this *
* scope. $color is because we declared it *
* as global. */
foo(); // A green apple
echo "A $color $fruit"; // A green
?>
當(dāng)一個(gè)文件被包括時(shí)，語(yǔ)法解析器在目標(biāo)文件的開(kāi)頭脫離PHP 模式并進(jìn)入HTML 模式，到文件結(jié)尾處恢復(fù)。由于此原因，目標(biāo)文件中應(yīng)被當(dāng)作PHP 代碼執(zhí)行的任何代碼都必須被包括在有效的PHP 起始和結(jié)束標(biāo)記之中。
如果“URL fopen wrappers”在PHP 中被激活（默認(rèn)配置），可以用URL（通過(guò)HTTP）而不是本地文件來(lái)指定要被包括的文件。如果目標(biāo)服務(wù)器將目標(biāo)文件作為PHP 代碼解釋?zhuān)瑒t可以用適用于HTTP GET 的URL 請(qǐng)求字符串來(lái)向被包括的文件傳遞變量。嚴(yán)格的說(shuō)這和包括一個(gè)文件并繼承父文件的變量空間并不是一回事；該腳本文件實(shí)際上已經(jīng)在遠(yuǎn)程服務(wù)器上運(yùn)行了，而本地 腳本則包括了其結(jié)果。
警告
Windows 版本的PHP 目前還不支持該函數(shù)的遠(yuǎn)程文件訪問(wèn)，即使allow_url_fopen 選項(xiàng)已被激活。
例子12-5. 通過(guò)HTTP 進(jìn)行的include()
復(fù)制代碼 代碼如下:
<?php
/* This example assumes that www.example.com is configured to parse .php *
* files and not .txt files. Also, 'Works' here means that the variables *
* $foo and $bar are available within the included file. */
// Won't work; file.txt wasn't handled by www.example.com as PHP
include 'http://www.example.com/file.txt?foo=1&bar=2';
// Won't work; looks for a file named 'file.php?foo=1&bar=2' on the
// local filesystem.
include 'file.php?foo=1&bar=2';
// Works.
include 'http://www.example.com/file.php?foo=1&bar=2';
$foo = 1;
$bar = 2;
include 'file.txt'; // Works.
include 'file.php'; // Works.
?>
相關(guān)信息參見(jiàn)使用遠(yuǎn)程文件，fopen() 和file()。
因?yàn)閕nclude() 和require() 是特殊的語(yǔ)言結(jié)構(gòu)，在條件語(yǔ)句中使用必須將其放在語(yǔ)句組中（花括號(hào)中）。
例子12-6. include() 與條件語(yǔ)句組
復(fù)制代碼 代碼如下:
<?php
// This is WRONG and will not work as desired.
if ($condition)
include $file;
else
include $other;
// This is CORRECT.
if ($condition) {
include $file;
} else {
include $other;
}
?>
處理返回值：可以在被包括的文件中使用return() 語(yǔ)句來(lái)終止該文件中程序的執(zhí)行并返回調(diào)用它的腳本。同樣也可以從被包括的文件中返回值。可以像普通函數(shù)一樣獲得include 呼叫的返回值。
注: 在PHP 3 中，除非是在函數(shù)中調(diào)用否則被包括的文件中不能出現(xiàn)return。在此情況下return() 作用于該函數(shù)而不是整個(gè)文件。
例子12-7. include() 和return() 語(yǔ)句
return.php
復(fù)制代碼 代碼如下:
<?php
$var = 'PHP';
return $var;
?>
noreturn.php
復(fù)制代碼 代碼如下:
<?php
$var = 'PHP';
?>
testreturns.php
復(fù)制代碼 代碼如下:
<?php
$foo = include 'return.php';
echo $foo; // prints 'PHP'
$bar = include 'noreturn.php';
echo $bar; // prints 1
?>
$bar 的值為1 是因?yàn)閕nclude 成功運(yùn)行了。注意以上例子中的區(qū)別。第一個(gè)在被包括的文件中用了return() 而另一個(gè)沒(méi)有。其它幾種把文件“包括”到變量的方法是用fopen()，file() 或者include() 連同輸出控制函數(shù)一起使用。
