## 包含語句 ### include `include` 語句包含并運行指定文件。 文件查找順序： * 被包含文件先按參數給出的路徑尋找。 * 如果沒有給出目錄（只有文件名）時則按照 `include_path` 指定的目錄尋找。 * 如果在 `include_path` 下沒找到該文件，在調用腳本文件所在的目錄和當前工作目錄下尋找。 如果最后仍未找到文件則會發出一條警告（E_WARNING）, 腳本繼續執行。 當一個文件被包含時，其中所包含的代碼繼承了 `include` 所在行的變量范圍。 從該處開始，調用文件在該行處可用的任何變量在被調用的文件中也都可用。 不過所有在包含文件中定義的函數和類都具有全局作用域。 ``` vars.php <?php $color = 'green'; $fruit = 'apple'; echo "I am vars.php" . PHP_EOL; ?> test.php <?php echo "A {$color} {$fruit}" . PHP_EOL; // A include 'vars.php'; include 'vars.php'; // include again echo "A {$color} {$fruit}" . PHP_EOL; // A green apple ?> ``` 如果 `include` 出現于調用文件中的一個函數里，則被調用的文件中所包含的所有代碼將表現得如同它們是在該函數內部定義的一樣。所以它將遵循該函數的變量范圍。 ``` <?php function foo() { global $color; include 'vars.php'; echo "A {$color} {$fruit}" . PHP_EOL; } foo(); // A green apple echo "A {$color} {$fruit}" . PHP_EOL; // A green ?> ``` `include` 結合 `return` 語句 ``` db.php <?php $db = array( 'host' => 'localhost', 'user' => 'root', 'password' => '123456', 'port' => 3306, 'dbname' => 'test', ); return $db; ?> test.php <?php $db = include 'db.php'; var_dump($db); ?> ``` ### include_once 此行為和 `include` 語句類似，唯一區別是如果該文件中已經被包含過，則不會再次包含。 ``` vars.php <?php $color = 'green'; $fruit = 'apple'; echo "I am vars.php" . PHP_EOL; ?> test.php <?php include_once 'vars.php'; include_once 'vars.php'; // include again echo "A {$color} {$fruit}" . PHP_EOL; // A green apple ?> ``` ### require 文件的查找方式和 `include` 一樣，如果沒有找到包含文件，則會發出致命錯誤（E_COMPILE_ERROR），腳本停止執行。 ### require_once 此行為和 `require` 語句類似，唯一區別是如果該文件中已經被包含過，則不會再次包含。