引用文件是 PHP 的核心特性之一。將常用函數、配置或類別集中放在單一檔案,其他頁面透過 require 或 include 引入,即可復用代碼,避免重複撰寫,降低維護成本,利於二次開發。
require vs include 核心差異| 特性 | require | include |
|---|---|---|
| 引用失敗後果 | 產生 E_COMPILE_ERROR 致命錯誤,腳本終止執行。 | 產生 E_WARNING 警告,腳本繼續執行。 |
| 返回值 | 無返回值(實際上成功時返回 1,但通常不依賴此值)。 | 有返回值(成功返回 1,失敗返回 false)。 |
| 執行時機 | 腳本啟動前編譯階段即讀入,成為腳本一部分。 | 運行時遇到該行才引入。 |
| 效能 | 相對較快(編譯期處理)。 | 稍慢(運行期處理)。 |
| 建議用法 | 核心配置、資料庫連線、核心類別庫等必須存在的文件,置於腳本最前端。 | 流程控制中條件性引入的模板、片段等非核心文件。 |
<?php
// 核心文件:放在最前面,確保先載入
require('sql.php'); // 如資料庫連線配置
echo '引用文件示範';
// 非核心文件:放在業務邏輯中
include('hello-world.php');
?>
_once 變體當多個文件可能引用同一底層文件時,使用 require_once() 或 include_once() 確保同一腳本執行周期內僅載入一次,避免函數重複定義錯誤。
<?php
require_once('sql.php'); // 即使多處調用,也只載入一次
echo '引用文件示範';
include_once('hello-world.php');
?>
require:確保缺失即報錯停止,防止後續邏輯在錯誤狀態下運行。include:允許優雅降級。_once:消除重複定義風險。__DIR__ 構建絕對路徑(如 require_once __DIR__ . '/config.php';),避免相對路徑在不同入口文件下失效。