PHP - 檔案包含

你可以在伺服器執行之前，將一個 PHP 檔案的內容包含到另一個 PHP 檔案中。有兩個 PHP 函式可以用來將一個 PHP 檔案包含到另一個 PHP 檔案中。

• include() 函式

• require() 函式

這是 PHP 的一個強項，它有助於建立可在多個頁面上重用的函式、頁首、頁尾或元素。這將有助於開發人員輕鬆地以最小的努力更改整個網站的佈局。如果需要任何更改，則只需更改包含的檔案，而無需更改數千個檔案。

include() 函式

include() 函式獲取指定檔案中的所有文字並將其複製到使用 include 函式的檔案中。如果載入檔案時出現任何問題，則include()函式會生成警告，但指令碼將繼續執行。

假設你想要為你的網站建立一個通用的選單。然後建立一個名為 menu.php 的檔案，內容如下。

<a href="https://tutorialspoint.tw/index.htm">Home</a> 
<a href="https://tutorialspoint.tw/ebxml">ebXML</a>   
<a href="https://tutorialspoint.tw/ajax">AJAX</a>   
<a href="https://tutorialspoint.tw/perl">PERL</a> 

現在建立任意數量的頁面，幷包含此檔案來建立頁首。例如，現在你的 test.php 檔案可以包含以下內容。

<?php <b>include("menu.php");</b> ?>
<p>This is an example to show how to include PHP file!</p>

它將產生以下結果：

require() 函式

require() 函式獲取指定檔案中的所有文字並將其複製到使用 include 函式的檔案中。如果載入檔案時出現任何問題，則require()函式會生成致命錯誤並停止指令碼的執行。

因此，require() 和 include() 之間的區別僅在於它們處理錯誤條件的方式。建議使用 require() 函式而不是 include() 函式，因為如果檔案丟失或名稱錯誤，指令碼不應繼續執行。

你可以嘗試使用上面的例子與 require() 函式，它將產生相同的結果。但是，如果你嘗試以下兩個例子，其中檔案不存在，那麼你將得到不同的結果。

<?php include("xxmenu.php"); ?>
<p>This is an example to show how to include wrong PHP file!</p>

這將產生以下結果：

This is an example to show how to include wrong PHP file!

現在讓我們嘗試使用 require() 函式的相同示例。

<?php <b>require("xxmenu.php");</b> ?>
<p>This is an example to show how to include wrong PHP file!</p>

這次檔案執行停止，沒有任何內容顯示。

注意 - 你可能會收到簡單的警告訊息、致命錯誤訊息或根本沒有任何訊息。這取決於你的 PHP 伺服器配置。