您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 相關知識

PHP include 與 require 區別深度解析：加載機制、錯誤處理、性能與最佳實踐

編輯：PHP 相關知識

前言

include、require、include_once、require_once 是 PHP 代碼復用的核心機制。雖然功能相似（引入並執行指定文件），但它們在**加載時機、錯誤級別、條件執行、性能**上存在關鍵差異。本文從底層原理到實戰場景全方位解析。

核心差異對比表

特性	`require`	`include`	`require_once`	`include_once`
加載時機	編譯階段（腳本啟動前）	運行階段（執行到該行時）	編譯階段	運行階段
文件不存在	Fatal Error (E_COMPILE_ERROR)，腳本立即終止	Warning (E_WARNING)，腳本繼續執行	Fatal Error	Warning
條件引入	❌ 無條件（編譯時已載入）	✅ 支持（如 `if($cond) include 'a.php';`）	❌	✅
重複引入	允許重複執行	允許重複執行	僅引入一次	僅引入一次
返回值處理	可接收被引文件 `return` 值	可接收 `return` 值	首次引入可接收	首次引入可接收
性能開銷	略低（編譯期完成）	略高（運行期解析路徑、檢查）	略高（需維護已載入表）	略高

底層原理深度解析

1. require：編譯期靜態綁定

PHP 解析器在**編譯階段**遇到 require 會：

解析路徑（相對/絕對/Include Path）。
讀取文件內容，**將文件代碼直接內聯插入**當前腳本的 AST（抽象語法樹）中。
編譯合併後的代碼生成 opcode。

後果：

無法在 if(false) require 'a.php'; 中避免加載 —— 依然會編譯 a.php 並報錯（若不存在）。
被引文件語法錯誤導致**主腳本編譯失敗**，無法運行。
變量作用域：被引文件繼承調用處作用域（函數內 require 則在函數作用域）。

2. include：運行期動態加載

PHP 在**運行到該行**時才：

解析路徑、讀取文件。
編譯文件代碼生成臨時 opcode。
執行該 opcode，返回流程控制權。

後果：

支持動態條件加載：if($need) include "module_{$type}.php";
文件不存在只拋 Warning，主流程可繼續（如降級、備選方案）。
每次執行到該行都會重新編譯執行（除非 opcode 緩存如 OPcache 生效）。

3. _once 變體：防止重複定義

內部維護一個「已加載文件實際路徑」哈希表（realpath() 後的路徑）。再次引入相同文件直接跳過。**注意**：符號鏈接、大小寫不敏感文件系統（Windows/macOS）下，不同路徑指向同一文件可能被重複加載。

實戰場景與最佳實踐

場景一：核心配置、基礎類庫 → `require_once`

<?php
// bootstrap.php
require_once __DIR__ . '/config/database.php';
require_once __DIR__ . '/vendor/autoload.php'; // Composer 自動加載
require_once __DIR__ . '/core/Application.php';

理由：系統啟動必須依賴，缺失即致命錯誤，防止重複定義類/常量。

場景二：模塊化業務邏輯、插件系統 → `include`

<?php
// 動態加載支付網關
$gateway = $_GET['gateway'] ?? 'alipay';
$file = __DIR__ . "/gateways/{$gateway}.php";

if (is_file($file)) {
    include $file; // 運行時決策，支持新增文件無需改代碼
    $handler = new $gateway\Handler();
} else {
    throw new Exception("不支持的網關: $gateway");
}

場景三：模板文件（含輸出） → `include`

<?php
// 內部可使用 $title, $content 變量
include __DIR__ . '/views/article.php'; 
// article.php 內容：
// <h1><?= $title ?></h1>
// <div><?= $content ?></div>

場景四：函數庫返回值 → `include`/`require`

<?php
// config.php
return [
    'db' => ['host' => 'localhost', 'name' => 'test'],
    'debug' => true,
];

// 使用
$config = include 'config.php'; // 接收 return 值
// 或
$config = require 'config.php'; // 同樣可接收

性能優化：OPcache 讓差異微乎其微

開啟 OPcache (opcache.enable=1) 後：

所有 PHP 文件編譯後的 opcode 緩存到共享內存。
require/include 變為從內存獲取 opcode，**無磁盤 IO、無編譯開銷**。
運行時路徑解析（realpath）仍有微小開銷，可用絕對路徑或常量 __DIR__ 避免。

建議：生產環境**必須開啟 OPcache**，此時四者性能差異可忽略，優先考慮語義正確性。

常見陷阱與避坑指南

相對路徑陷阱：include 'a.php' 相對「當前工作目錄」（getcwd()），非腳本所在目錄。統一使用 __DIR__ . '/a.php'。
require 在函數中導致作用域隔離

function loadConfig() {
    require 'config.php'; // config.php 中的 $config 變成局部變量！
    return $config;       // 必須返回
}
$config = loadConfig();

循環引入死循環：A require B，B require A。PHP 會檢測並報 Fatal Error，但邏輯設計應避免。
大小寫敏感性：Linux 區分大小寫，Windows/macOS 默認不區分。文件名、類名、命名空間嚴格統一大小寫（PSR-4/PSR-1）。
include_path 污染：避免依賴 include_path，顯式指定完整路徑，提高可讀性與性能。

現代替代方案：Composer PSR-4 自動加載

現代 PHP 項目**不再手寫 require/include 業務類**，而是：

// composer.json
{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}
// 執行 composer dump-autoload

// 入口文件唯一 require
require_once __DIR__ . '/vendor/autoload.php';

// 之後直接使用
use App\Controller\UserController;
use App\Model\User;

優勢：零配置按需加載、統一命名規範、支持開發環境熱更新、生產環境優化類映射表（classmap）。