ThinkPHP 3.2 引入 **編譯緩存合併** 機制:將框架核心類、公共函數、配置、路由等**高頻文件合併為單一 lite.php**,替換入口文件中的 require 'ThinkPHP/ThinkPHP.php',**減少文件 I/O、提升啟動速度 30%-50%**。
define('APP_DEBUG', false); (生產環境必須)。define('BUILD_LITE_FILE', true);
require './ThinkPHP/ThinkPHP.php';
Runtime/ 生成 lite.php。Runtime/lite.php 存在且大小 > 500KB。// 入口文件或應用配置 config.php
'RUNTIME_LITE_FILE' => APP_PATH . 'lite.php', // 指定輸出位置
// 應用配置目錄下建立 lite.php 返回編譯文件列表
return [
THINK_PATH . 'Common/functions.php',
COMMON_PATH . 'Common/function.php',
CORE_PATH . 'Think' . EXT,
CORE_PATH . 'Hook' . EXT,
CORE_PATH . 'App' . EXT,
CORE_PATH . 'Dispatcher' . EXT,
CORE_PATH . 'Model' . EXT,
CORE_PATH . 'Log' . EXT,
CORE_PATH . 'Log/Driver/File' . EXT,
CORE_PATH . 'Route' . EXT,
CORE_PATH . 'Controller' . EXT,
CORE_PATH . 'View' . EXT,
CORE_PATH . 'Storage' . EXT,
CORE_PATH . 'Storage/Driver/File' . EXT,
CORE_PATH . 'Exception' . EXT,
BEHAVIOR_PATH . 'ParseTemplateBehavior' . EXT,
BEHAVIOR_PATH . 'ContentReplaceBehavior' . EXT,
// 可加入項目常用類庫、第三方庫入口文件
];
// index.php (原)
require './ThinkPHP/ThinkPHP.php';
// 修改為
require './Runtime/lite.php'; // 或 APP_PATH . 'lite.php'
效果:框架核心類已合併,無需再載入 ThinkPHP.php,編譯緩存目錄 Runtime/~app.php 也不再生成/讀取。
Runtime/lite.php 到 Web 根目錄重命名為 index.php。index.php 備份為 index.bootstrap.php (用於重新生成)。⚠️ 注意:此模式下**無法再動態修改框架核心、公共函數、配置**,任何變更需刪除 lite.php 重新生成。
ThinkPHP 5.0+ **移除 Lite 機制**,改用 **Composer 自動加載 + OpCache + 預加載 (PHP 7.4+)** 實現同等甚至更優性能。升級時請移除 BUILD_LITE_FILE 相關代碼,配置 opcache.preload。
Lite 文件是 ThinkPHP 3.2 時代的經典優化手段,**一鍵生成、替換入口、立竿見影**。理解其原理 (合併高頻文件、減少 require、配合 OpCache) 有助於理解現代 PHP 性能優化的核心思想:減少文件系統交互、最大化 OpCache 命中、預加載熱點代碼。