萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP include 與 require 差異完整比較與最佳實務

核心差異:錯誤處理方式

基本用法

<?php include("header.php"); ?>
<?php require("config.php"); ?>

實際輸出差異示範

include 錯誤時

Warning: include(wrongFile.php): failed to open stream...
Warning: include(): Failed opening 'wrongFile.php'...
Hello World! // 繼續執行

require 錯誤時

Warning: require(wrongFile.php): failed to open stream...
Fatal error: require(): Failed opening required 'wrongFile.php'...
// 腳本終止,不會輸出 Hello World!

防重複引入:_once 變體

  • include_once() / require_once():同一檔案在同一次請求中只會被引入一次
  • 避免函數/類別重複定義錯誤
  • 效能微小影響,現代 PHP 已優化,建議預設使用 _once 版本

路徑解析規則

  1. 若給絕對路徑(以 / 或磁碟機開頭),直接使用
  2. 若給相對路徑,依 include_path 設定搜尋
  3. 當前腳本目錄優先於 include_path
// 推薦:使用 __DIR__ 確保路徑正確
require_once __DIR__ . '/config/database.php';
include_once __DIR__ . '/../vendor/autoload.php';

效能考量

  • OpCache 啟用後,編譯後的 opcode 會快取,重複引入開銷極低
  • 避免在迴圈中引入檔案,移至迴圈外
  • 大型專案使用 Composer 自動載入(PSR-4),減少手動 include

最佳實務總結

  • 核心依賴用 require_once
  • 可選組件用 include_once
  • 永遠使用絕對路徑(__DIR__)
  • 入口檔案統一引入自動載入器,業務代碼不再手動 include
copyright © 萬盛學電腦網 all rights reserved
特性includerequire
檔案不存在發出 Warning,腳本繼續執行發出 Fatal Error,腳本立即停止
適用場景非核心檔案(側邊欄、廣告、Widget)核心檔案(設定、資料庫連線、核心類別)