PHP include 與 require 差異完整解析：載入機制、變數範圍、返回值與最佳實踐

核心差異一覽

基本語法與變數範圍繼承

<?php
// vars.php
$color = 'green';
$fruit = 'apple';
?>

// test.php
echo "A $color $fruit"; // A (變數尚未定義)

include 'vars.php';

echo "A $color $fruit"; // A green apple
?>

被載入檔案繼承 include 所在行的變數範圍。若在函數內 include，則遵循函數區域範圍。

函數內 include 範圍示例

<?php
function foo() {
    global $color;
    include 'vars.php'; // $color 為全域，$fruit 為區域
    echo "A $color $fruit"; // A green apple
}
foo();
echo "A $color $fruit"; // A green ($fruit 不在全域)
?>

HTML 模式切換與 PHP 標籤

載入檔案時，解析器會：

1. 進入 HTML 模式（輸出模式）
2. 遇到 <?php 切回 PHP 模式
3. 檔案結尾恢復呼叫端模式

結論：被載入檔案的 PHP 程式碼必須包裹在 <?php ... ?> 中，否則會直接輸出原始碼。

遠端檔案載入（URL fopen wrapper）

<?php
// 遠端 PHP 檔案會在遠端執行，本地只拿到輸出結果
include 'https://example.com/file.php?foo=1&bar=2';

// 本地檔案才會繼承變數範圍
$foo = 1; $bar = 2;
include 'file.php'; // 正確
?>

注意：Windows 版 PHP 不支援遠端 include，即使開啟 allow_url_fopen。

條件式載入必須用大括號

<?php
// ❌ 錯誤：語法結構不完整
if ($condition)
    include $file;
else
    include $other;

// ✅ 正確：語句區塊
if ($condition) {
    include $file;
} else {
    include $other;
}
?>

返回值處理

<?php
// return.php
$var = 'PHP';
return $var;

// noreturn.php
$var = 'PHP';
// 無 return

// test.php
$foo = include 'return.php';  // $foo = 'PHP'
$bar = include 'noreturn.php'; // $bar = 1 (載入成功回傳 1)
?>

• 被載入檔案可用 return 終止執行並回傳值
• 呼叫端可接收返回值：$result = include 'file.php'
• 無 return 時，成功載入回傳 1
• PHP 3 僅支援函數內 return，PHP 4+ 支援頂層

include_once / require_once

防止重複載入同一檔案（比較實際路徑，含符號連結解析），適用於類別定義檔。

最佳實踐建議

1. 現代專案使用 Composer 自動載入（PSR-4），避免手動 include
2. 核心依賴用 require，模板/片段用 include
3. 絕對路徑：__DIR__ . '/config.php' 避免路徑解析歧義
4. 不要在循環中 include，預先載入或使用自動載入
5. 錯誤處理：@include 抑制警告不推薦，應預先檢查 file_exists 或使用 spl_autoload_register