PHP Include 文件

服務器端包含 (SSI) 用于創建可在多個頁面重復使用的函數、頁眉、頁腳或元素。

include （或 require）語句會獲取指定文件中存在的所有文本/代碼/標記，并復制到使用 include 語句的文件中。

包含文件很有用，如果您需要在網站的多張頁面上引用相同的 PHP、HTML 或文本的話。

PHP include 和 require 語句

通過 include 或 require 語句，可以將 PHP 文件的內容插入另一個 PHP 文件（在服務器執行它之前）。

include 和 require 語句是相同的，除了錯誤處理方面：

  • require 會生成致命錯誤（E_COMPILE_ERROR）并停止腳本
  • include 只生成警告（E_WARNING），并且腳本會繼續

因此，如果您希望繼續執行，并向用戶輸出結果，即使包含文件已丟失，那么請使用 include。否則，在框架、CMS 或者復雜的 PHP 應用程序編程中，請始終使用 require 向執行流引用關鍵文件。這有助于提高應用程序的安全性和完整性，在某個關鍵文件意外丟失的情況下。

包含文件省去了大量的工作。這意味著您可以為所有頁面創建標準頁頭、頁腳或者菜單文件。然后，在頁頭需要更新時，您只需更新這個頁頭包含文件即可。

語法

include 'filename';

或

require 'filename';

PHP include 實例

例子 1

假設我們有一個名為 "footer.php" 的標準的頁腳文件，就像這樣：

<?php
echo "<p>Copyright © 2006-" . date("Y") . " codew3c.com</p>";
?>

如需在一張頁面中引用這個頁腳文件，請使用 include 語句：

<html>
<body>
<h1>歡迎訪問我們的首頁！</h1>
<p>一段文本。</p>
<p>一段文本。</p>
<?php include 'footer.php';?>
</body>
</html>

運行實例

例子 2

假設我們有一個名為 "menu.php" 的標準菜單文件：

<?php
echo '<a href="/index.asp">首頁</a> -
<a href="/html/index.asp">HTML 教程</a> -
<a href="/css/index.asp">CSS 教程</a> -
<a href="/js/index.asp">JavaScript 教程</a> -
<a href="/php/index.asp">PHP 教程</a>';
?>

網站中的所有頁面均使用此菜單文件。具體的做法是（我們使用了一個 <div> 元素，這樣今后就可以輕松地通過 CSS 設置樣式）：

<html>
<body>
<div class="menu">
<?php include 'menu.php';?>
</div>
<h1>歡迎訪問我的首頁！</h1>
<p>Some text.</p>
<p>Some more text.</p>
</body>
</html>

運行實例

例子 3

假設我們有一個名為 "vars.php" 的文件，其中定義了一些變量：

<?php
$color='銀色的';
$car='奔馳轎車';
?>

然后，如果我們引用這個 "vars.php" 文件，就可以在調用文件中使用這些變量：

<html>
<body>
<h1>歡迎訪問我的首頁！</h1>
<?php
include 'vars.php';
echo "我有一輛" . $color . $car "。";
?>
</body>
</html>

運行實例

PHP include vs. require

require 語句同樣用于向 PHP 代碼中引用文件。

不過，include 與 require 有一個巨大的差異：如果用 include 語句引用某個文件并且 PHP 無法找到它，腳本會繼續執行：

實例

<html>
<body>
<h1>Welcome to my home page!</h1>
<?php
include 'noFileExists.php';
echo "I have a $color $car.";
?>
</body>
</html>

運行實例

如果我們使用 require 語句完成相同的案例，echo 語句不會繼續執行，因為在 require 語句返回嚴重錯誤之后腳本就會終止執行：

實例

<html>
<body>
<h1>Welcome to my home page!</h1>
<?php
require 'noFileExists.php';
echo "I have a $color $car.";
?>
</body>
</html>

運行實例

注釋：

請在此時使用 require：當文件被應用程序請求時。

請在此時使用 include：當文件不是必需的，且應用程序在文件未找到時應該繼續運行時。