PHP教學-Include文件
伺服器端包含 (SSI) 用於新增可在多個頁面重複使用的函數、頁首、頁尾或元素。
include (或 require)語句會獲取指定文件中存在的所有文本/程式碼/標記,並複製到使用 include 語句的文件中。
包含文件很有用,如果您需要在網站的多張頁面上引用相同的 PHP、HTML 或文本的話。
PHP include 和 require 語句
通過 include 或 require 語句,可以將 PHP 文件的內容插入另一個 PHP 文件(在伺服器執行它之前)。
include 和 require 語句是相同的,除了錯誤處理方面:
require 會產生致命錯誤(E_COMPILE_ERROR)並停止scripts
include 只產生警告(E_WARNING),並且scripts會繼續
因 此,如果您希望繼續執行,並向用戶輸出結果,即使包含文件已丟失,那麼請使用 include。否則,在框架、CMS 或者複雜的 PHP 套用程式編程中,請始終使用 require 向執行流引用關鍵文件。這有助於提高套用程式的安全性和完整性,在某個關鍵文件意外丟失的情況下。
包含文件省去了大量的工作。這意味著您可以為所有頁面新增標準頁頭、頁尾或者菜單文件。然後,在頁頭需要更新時,您只需更新這個頁頭包含文件即可。
語法
include 'filename';
或
require 'filename';
PHP include 範例
例子 1
假設我們有一個名為 "footer.php" 的標準的頁尾文件,就像這樣:
如需在一張頁面中引用這個頁尾文件,請使用 include 語句:
include (或 require)語句會獲取指定文件中存在的所有文本/程式碼/標記,並複製到使用 include 語句的文件中。
包含文件很有用,如果您需要在網站的多張頁面上引用相同的 PHP、HTML 或文本的話。
PHP include 和 require 語句
通過 include 或 require 語句,可以將 PHP 文件的內容插入另一個 PHP 文件(在伺服器執行它之前)。
include 和 require 語句是相同的,除了錯誤處理方面:
require 會產生致命錯誤(E_COMPILE_ERROR)並停止scripts
include 只產生警告(E_WARNING),並且scripts會繼續
因 此,如果您希望繼續執行,並向用戶輸出結果,即使包含文件已丟失,那麼請使用 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" 的標準菜單文件:
網站中的所有頁面均使用此菜單文件。具體的做法是(我們使用了一個 <div> 元素,這樣今後就可以輕鬆地通過 CSS 設置樣式):
假設我們有一個名為 "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" 的文件,其中定義了一些變數:
然後,如果我們引用這個 "vars.php" 文件,就可以在呼叫文件中使用這些變數:
假設我們有一個名為 "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 無法找到它,scripts會繼續執行:
範例
require 語句同樣用於向 PHP 程式碼中引用文件。
不過,include 與 require 有一個巨大的差異:如果用 include 語句引用某個文件並且 PHP 無法找到它,scripts會繼續執行:
範例
<html> <body> <h1>Welcome to my home page!</h1> <?php include 'noFileExists.php'; echo "I have a $color $car."; ?> </body> </html>
如果我們使用 require 語句完成相同的案例,echo 語句不會繼續執行,因為在 require 語句返回嚴重錯誤之後scripts就會終止執行:
範例
範例
<html> <body> <h1>Welcome to my home page!</h1> <?php require 'noFileExists.php'; echo "I have a $color $car."; ?> </body> </html>
註釋:
請在此時使用 require:當文件被套用程式請求時。
請在此時使用 include:當文件不是必需的,且套用程式在文件未找到時應該繼續執行時。
請在此時使用 require:當文件被套用程式請求時。
請在此時使用 include:當文件不是必需的,且套用程式在文件未找到時應該繼續執行時。
留言
張貼留言