PHP - 文件包含

你好，未来的 PHP 巫師們！今天，我們將踏上一段令人興奮的旅程，探索 PHP 中的文件包含世界。作為你們親切友善的電腦老師，我在這裡指導你們掌握這個重要概念，它將使你的 PHP 編程生活變得更加輕鬆。所以，來一杯咖啡（或者如果你喜歡，來一杯茶），我們一起來深入研究吧！

PHP - File Include

PHP 中的 "include" 語句

文件包含是什麼？

想像一下你正在建造一座巨大的樂高城堡。如果你可以使用預製的部分，而不是從頭開始創造每一塊積木，豈不是很好？這正是 PHP 中的文件包含所做的事情！它允許你從其他文件中引入代碼，就像將預製的樂高部分加入到你的城堡中一樣。

如何使用 "include" 語句

讓我們從一個簡單的例子開始：

<?php
include 'header.php';
echo "歡迎來到我的網站！";
include 'footer.php';
?>

在這個例子中，我們包含了兩個文件：header.php 和 footer.php。這裡發生了什麼：

PHP 尋找名為 header.php 的文件，並在該位置插入其內容。
然後它會輸出我們的歡迎信息。
最後，它包含 footer.php 的內容。

這對於像網站模板這樣的事情非常有用，你希望在多個頁面上使用相同的頁眉和頁腳！

使用 "include" 的好處

代碼重用性：寫一次，多次使用！
更容易維護：在一個地方更新，更改會反映到每個地方。
更乾淨的代碼：你的主文件保持整潔有序。

真實世界的例子

假設我們有一個簡單的網站，有多個頁面。我們可以為常用元素創建分離的文件：

header.php:

<!DOCTYPE html>
<html>
<head>
<title>我的超棒網站</title>
</head>
<body>
<header>
<h1>歡迎來到我的網站</h1>
<nav>
<a href="index.php">首頁</a>
<a href="about.php">關於</a>
<a href="contact.php">聯繫</a>
</nav>
</header>

footer.php:

<footer>
<p>&copy; 2023 我的超棒網站</p>
</footer>
</body>
</html>

現在，我們的 index.php 可以像這樣：

<?php include 'header.php'; ?>

<main>
<h2>首頁</h2>
<p>歡迎來到我的超棒網站！</p>
</main>

<?php include 'footer.php'; ?>

看起來多麼乾淨和有組織？就像魔法一樣！?✨

PHP – Include 與 Require

現在你可能會想，"引入文件只有 'include' 這一種方式嗎？" 這個問題問得好！讓我向你介紹 'require' —— 'include' 的更严格的兄弟。

差異

include 和 require 都有包含文件的基本功能，但它們處理錯誤的方式不同：

如果文件找不到，include 只會生成一個警告（E_WARNING），並且腚本會繼續運行。
如果文件找不到，require 將生成一個致命錯誤（E_COMPILE_ERROR）並停止腚本執行。

讓我們看看這是怎麼工作的：

<?php
// 這會顯示一個警告但會繼續執行
include '不存在文件.php';
echo "這行會被執行。";

// 這會顯示一個錯誤並停止執行
require '另一個不存在文件.php';
echo "這行永遠不會被達到。";
?>

當使用哪一個？

這裡有一個方便的表格來幫助你決定：

語句	使用時機	示例場景
include	文件對腚本運行不是必需的	引入側邊欄或附加內容
require	文件對腚本運行絕對必要	引入數據庫連接細節或關鍵功能

Include/Require 的變體

PHP 還提供了 include_once 和 require_once。這些語句保證文件只被包含一次，這對於防止重複的函數定義或變量賦值非常有用。

<?php
include_once 'config.php';
// 即使我們再次調用它，它也不會第二次包含
include_once 'config.php';
?>

這在處理大型項目時特別有用，因為多個文件可能會試圖包含同一個文件。

結論

好了，各位！你們剛剛通過文件包含提升了你的 PHP 技能。記住，使用 include 和 require 就像在廚房裡有一個有才華的二廚——他們為你準備所有的食材，這樣你可以專注於創造主菜。

隨著你繼續你的 PHP 旅程，你會發現掌握文件包含會使你的代碼更加有組織、高效和容易維護。這就像把你的樂高積木整齊地分類——每樣東西都有它自己的位置，你可以更快地建造令人驚奇的事物！

繼續練習，保持好奇心，在你知道之前，你會像專業廚師創造美味佳肴一樣，快速地烹飪出複雜的 PHP 應用程序。開心地編程，願你的包含總是能找到它們的文件！??

Credits: Image by storyset