PHP require 在類繼承中的陷阱：為何團隊規範推薦 require_once

問題背景

PHP 提供四種檔案引入語句：include、include_once、require、require_once。雖然功能相似，但在「多子類繼承同一父類」的場景下，require 會觸發 Cannot redeclare class 致命錯誤，而 require_once 則能完美避開。

錯誤重現

1. 定義抽象父類

<?php
// AbstractClass.php
abstract class AbstractClass {}

2. 兩個子類分別引入父類（使用 require）

<?php
// RequireClassA.php
require 'AbstractClass.php';
class RequireClassA extends AbstractClass {}

<?php
// RequireClassB.php
require 'AbstractClass.php';
class RequireClassB extends AbstractClass {}

3. 主程式同時引入兩個子類

<?php
// test.php
require_once 'RequireClassB.php';
require_once 'RequireClassA.php';

$A = new RequireClassA();
$B = new RequireClassB();

4. 執行結果

PHP Fatal error: Cannot redeclare class AbstractClass in /path/to/AbstractClass.php on line 2

根本原因剖析

• require 是語句而非函數： 每次遇到 require 就會**無條件編譯執行**該檔案。
• 編譯階段即報錯： PHP 在編譯 test.php 時，依序編譯 RequireClassB.php（載入一次 AbstractClass）、RequireClassA.php（再次載入 AbstractClass），導致類重複定義。
• require_once 的保護機制： 內建「已載入檔案表」，編譯前檢查，若已載入則跳過，避免重複定義。

為何不建議用 include？

include 同樣會重複執行，僅差別在失敗時產生 Warning 而非 Fatal error，但重複定義類的錯誤本質相同，同樣會導致 Cannot redeclare class。

最佳實踐建議

現代 PHP 的更好方案：Composer 自動載入

使用 PSR-4 自動載入器（vendor/autoload.php）徹底消除手動 require，由類映射表按需載入，從根源解決重複引入問題：

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

執行 composer dump-autoload 後，專案中任何地方直接 use App\AbstractClass; 即可，無需手動引入。

總結

require 在類繼承鏈中極易引發重複定義錯誤，require_once 以微小效能換取穩健性。現代 PHP 專案應全面採用 Composer 自動載入，將檔案引入交給成熟的自動載入器處理，專注於業務邏輯開發。