PHP include 與 require 核心區別深度解析：從編譯期到運行期

在 PHP 開發中，include 與 require 是最基礎的代碼復用機制，但許多開發者僅停留在「報錯等級不同」的表層認知。本文從 **編譯時機、條件執行、循環行為、錯誤處理、Opcode 緩存影響** 五個維度，徹底釐清兩者本質區別，指導正確選型。

核心區別總覽表

深度場景演示

場景一：條件載入的陷阱

<?php
// config_prod.php 包含生產環境密鑰
// config_dev.php 包含測試環境密鑰

$env = 'prod';

// ❌ 錯誤：require 編譯期無條件載入，兩個文件都會被編譯
// 若 config_dev.php 有語法錯誤，生產環境也會崩潰
if ($env === 'prod') {
    require 'config_prod.php';
} else {
    require 'config_dev.php';
}

// ✅ 正確：include 運行期條件載入，僅編譯滿足條件的分支
if ($env === 'prod') {
    include 'config_prod.php';
} else {
    include 'config_dev.php';
}

場景二：循環動態載入

<?php
// 需求：依次載入 module_1.php, module_2.php, module_3.php

// ❌ require 早期版本：每次循環都載入 module_1.php (編譯期展開)
// PHP 7+ 已修復，但語義仍為「無條件載入」
for ($i = 1; $i <= 3; $i++) {
    require "module_{$i}.php"; // 不推薦，語義不清
}

// ✅ include：運行期動態解析文件名，完美支持
for ($i = 1; $i <= 3; $i++) {
    include "module_{$i}.php"; // 推薦
}

場景三：錯誤處理流程差異

<?php
// missing.php 不存在

// test_require.php
require 'missing.php';
echo "這行永遠不會執行\n"; // Fatal error 終止

// test_include.php
include 'missing.php';
echo "這行會正常輸出\n"; // Warning 後繼續

輸出對比：

// require
Warning: require(missing.php): failed to open stream...
Fatal error: require(): Failed opening required 'missing.php'...

// include
Warning: include(missing.php): failed to open stream...
這行會正常輸出

場景四：OpCache 與預加載影響

; php.ini
opcache.preload = /var/www/preload.php

// preload.php
// ✅ 靜態依賴：編譯期可解析，自動預加載
require 'core/Config.php';
require 'core/Database.php';
require 'core/Router.php';

// ⚠️ 動態依賴：運行期才確定，需顯式 opcache_compile_file()
$plugins = glob(__DIR__ . '/plugins/*.php');
foreach ($plugins as $plugin) {
    include $plugin; // 不會被自動預加載
    // 需額外：opcache_compile_file($plugin);
}

現代 PHP 最佳實踐建議

1. 預設使用 require_once（核心依賴）

• 框架核心類、Composer 自動加載入口、配置文件
• 語義明確：「此文件必須存在且僅載入一次」
• 利於靜態分析工具 (PHPStan, Psalm) 構建依賴圖
• 配合 composer dump-autoload -o 生成類映射，極致性能

2. 條件/動態場景用 include_once

• 插件系統、主題模板、多語言包、可選擴展模塊
• 運行期決定載入，避免編譯期錯誤污染主流程
• 配合 file_exists() 或 is_readable() 預檢更安全

3. 模板渲染層推薦 include

function render(string $template, array $data): string {
    extract($data);
    ob_start();
    include __DIR__ . "/templates/{$template}.php"; // 模板內可用 $var
    return ob_get_clean();
}

模板屬於「視圖邏輯」，運行期動態決定，include 語義更貼切；且模板缺失不應導致整站崩潰（可降級顯示錯誤頁）。

4. 避免在循環/高頻路徑重複 include

// ❌ 反模式：每次請求重複編譯
foreach ($items as $item) {
    include 'render_item.php';
}

// ✅ 優化：捕獲模板內容一次，循環渲染
$tpl = file_get_contents('render_item.php');
foreach ($items as $item) {
    // 簡單替換或使用模板引擎
    echo str_replace('{{name}}', $item['name'], $tpl);
}

歷史演進與版本差異

「require 是骨架，include 是血肉。骨架必須堅不可摧，血肉可按需生長。」