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" 的標準的頁尾文件,就像這樣:
<?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 無法找到它,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:當文件不是必需的,且套用程式在文件未找到時應該繼續執行時。

留言

這個網誌中的熱門文章

c語言-關於#define用法

CMD常用網管指令

PHP 與 JavaScript 之間傳值利用 json