PHP - 檔案包含

你好，有抱負的 PHP 開發者們！今天，我們將要深入探討 PHP 中一個令人興奮且重要的主題：檔案包含。作為你們友好的鄰居電腦老師，我將帶領你們透過大量的範例和解釋來理解這個概念。所以，拿起你們最喜歡的飲料，放鬆身心，讓我們一起踏上這次編程冒險吧！

PHP - File Inclusion

檔案包含是什麼？

在我們進入細節之前，讓我們先了解檔案包含的意思。在 PHP 中，檔案包含是一種將一個 PHP 檔案的内容插入到另一個 PHP 檔案中的方法。這就像邀請你的朋友（另一個檔案）來參加你的派對（你的主 PHP 腳本）。這種技術幫助我們更好地組織代碼，並在多個頁面上重用常見的函數或 HTML。

`include()` 函數

我們這次旅程的第一站是 include() 函數。這個函數就像一個總是準備好幫助你的友好鄰居。讓我們看看它是如何工作的！

基本語法

include 'filename.php';

在這裡，'filename.php' 是你想要在當前腳本中包含的檔案。

範例 1：包含一個簡單的檔案

假設我們有兩個檔案：

header.php:

<header>
<h1>歡迎來到我棒的網站</h1>
<nav>
<a href="home.php">首頁</a>
<a href="about.php">關於</a>
<a href="contact.php">聯繫</a>
</nav>
</header>

index.php:

<!DOCTYPE html>
<html>
<body>
<?php include 'header.php'; ?>
<main>
<p>這是我主頁的主要內容。</p>
</main>
</body>
</html>

當你運行 index.php 時，它會顯示來自 header.php 的頁眉，然後是主要內容。這就像組裝拼圖一樣——每個部件（檔案）都完美地組合在一起，創造出完整的畫面（網頁）！

範例 2：包含含有變量的檔案

讓我們來點調味。我們也可以包含含有 PHP 變量和函數的檔案。

config.php:


<?php
$siteName = "編程者的樂園";
$year = date("Y");

function greet($name) { return "Hello, $name! 歡迎來到 $GLOBALS['siteName']!"; } ?>


2. `welcome.php`:
```php
<!DOCTYPE html>
<html>
<body>
<?php
include 'config.php';
$visitorName = "Alice";
echo "<h1>" . greet($visitorName) . "</h1>";
echo "<p>版權所有 © $year</p>";
?>
</body>
</html>

在這個範例中，welcome.php 包含 config.php，它提供了一個變量（$siteName）和一個函數（greet()）。這就像有一個萬用工具刀的有用工具在你手邊！

小貼士：路徑很重要！

使用 include() 時，記住檔案的路徑很重要。如果檔案在同一個目錄下，你可以只使用文件名。對於不同目錄下的文件，你需要提供正確的路徑。

include 'same_directory.php';
include '../parent_directory/file.php';
include './subdirectory/file.php';

`require()` 函數

現在，讓我們來認識 require()，它是 include() 的嚴格兄弟。雖然它們看起來很相似，但它們在處理錯誤時有一個關鍵的區別。

基本語法

require 'filename.php';

鍵區別

如果 include() 找不到文件，它會發出警告但繼續執行腳本。
如果 require() 找不到文件，它會抛出致命錯誤並停止腳本。

把 include() 當作一個建議，而 require() 則是一個要求。當檔案對你的腳本絕對必要時，使用 require()。

範例：使用 `require()`

假設我們有一個對我們腳本運行絕對必要的關鍵配置文件：

database_config.php:

<?php
$dbHost = "localhost";
$dbUser = "admin";
$dbPass = "secretpassword";
$dbName = "myapp_database";
?>

app.php:
```
<?php
require 'database_config.php';
```

//嘗試連接到數據庫 $connection = new mysqli($dbHost, $dbUser, $dbPass, $dbName);

if ($connection->connect_error) { die("連接失敗：" . $connection->connect_error); }

echo "成功連接到數據庫！"; ?>



在這種情況下，如果 `database_config.php` 遺失，腳本將立即停止，防止未定義變量的任何潛在問題。

## 比較：`include()` 與 `require()`

讓我們總結一下這些差異：

| 功能 | `include()` | `require()` |
|------|-------------|-------------|
| 錯誤處理 | 警告，腳本繼續執行 | 致命錯誤，腳本停止 |
| 使用情境 | 非關鍵文件 | 關鍵文件 |
| 多重包含 | 允許 | 允許 |
| 性能 | 稍微慢 | 稍微快 |

## 最佳實踐和建議

1. **對關鍵文件使用 `require()`**：如果您的腳本不能沒有某個文件，請使用 `require()`。

2. **對可選增強使用 `include()`**：對於添加功能但不是必需的文件，`include()` 是個不錯的選擇。

3. **避免重複**：使用 `include_once()` 或 `require_once()` 確保文件只被包含一次，防止函數重複定義或變量重賦值。

4. **安全第一**：對於動態包含，請始終驗證和清潔用於文件包含的任何用戶輸入，以防止潛在的安全漏洞。

5. **組織你的包含**：保持包含的文件在合理的目錄結構中，這會使你的項目隨著增長更容易管理。

## 結論

這就是了，未來的 PHP 巫師們！我們已經穿越了檔案包含的土地，見過了友好的 `include()` 和嚴格的 `require()`，並學會了如何有效地使用它們。記住，像任何強大的工具一樣，明智地使用檔案包含。它是保持代碼組織和可重用的絕佳方式，但始終要記住安全和效率。

在你們繼續 PHP 冒險的過程中，你會發現無數創造性地使用檔案包含的方法。也許你會創建一個每個部分都是單獨文件的模塊化網站，或者也許你會為你的應用程序建立一個插件系統。可能性無限！

持續編程，持續學習，最重要的是，玩得開心！直到下一次，願你的腳本運行順暢，咖啡濃郁。快樂編程！

Credits: Image by storyset