| 特性 | include | require |
| 檔案不存在 | 發出 Warning,腳本繼續執行 | 發出 Fatal Error,腳本立即停止 |
| 適用場景 | 非核心檔案(側邊欄、廣告、Widget) | 核心檔案(設定、資料庫連線、核心類別) |
基本用法
<?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 版本
路徑解析規則
- 若給絕對路徑(以
/ 或磁碟機開頭),直接使用
- 若給相對路徑,依
include_path 設定搜尋
- 當前腳本目錄優先於
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