PHP auto_prepend_file 與 auto_append_file 實戰應用指南

痛點背景

傳統做法在每支 PHP 檔案頂部 require('header.php')、底部 require('footer.php')，不僅重複勞動，修改路徑更需全站搜尋取代。PHP 內建的 auto_prepend_file 與 auto_append_file 指令完美解決此問題。

核心機制

• auto_prepend_file：腳本執行前自動引入指定檔案
• auto_append_file：腳本執行後自動引入指定檔案
• 僅支援單一檔案，但該檔案內可再 require 多個檔案

三種配置方式

1. php.ini 全域生效（需重啟服務）

auto_prepend_file = "/home/fdipzone/header.php"
auto_append_file  = "/home/fdipzone/footer.php"

優點：效能最佳（啟動時處理一次）；缺點：需管理員權限、影響全站、需重啟。

2. .htaccess 目錄級生效（即時生效）

php_value auto_prepend_file "/home/fdipzone/header.php"
php_value auto_append_file "/home/fdipzone/footer.php"

優點：無需重啟、無需管理員權限、彈性控制範圍；缺點：每請求皆解析 .htaccess，效能稍降。

3. 程式碼內動態設定（不推薦）

ini_set('auto_prepend_file', '/path/header.php');
ini_set('auto_append_file',  '/path/footer.php');

注意：ini_set 設定需在引入檔案之前執行，實務上極難把握時機，不建議使用。

實戰範例：統一版頭版尾

header.php

導覽列內容

footer.php

進階技巧與避坑

1. 排除特定頁面：在 header.php 開頭判斷 $_SERVER['SCRIPT_NAME'] 若為登入頁則 return 跳過輸出
2. 輸出緩衝控制：搭配 ob_start() 可在 header 中修改 HTTP 標頭
3. 效能監控：使用 auto_prepend_file 載入 Profiler 類別，自動統計所有頁面執行時間
4. 命名空間衝突：引入檔案在全域命名空間執行，避免使用 namespace 宣告

適用場景建議

總結

善用 auto_prepend_file/auto_append_file 可大幅減少樣板代碼，集中管理横切關注點。生產環境建議採 php.ini 方式以獲最佳效能；開發/測試環境或虛擬主機則用 .htaccess 靈活配置。