PHP Include 文件 · W3School PHP 教程

# 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") . " W3School.com.cn</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：當文件不是必需的，且應用程序在文件未找到時應該繼續運行時。 ")