ThinkPHP 3.2.2 引入插件控制器機制,允許透過 URL 參數動態切換控制器實作,實現模組級別的功能擴展與覆蓋。本文詳細說明配置、命名規範、目錄結構與實戰範例。
addon(預設值,可配置)指定插件名稱模組/Addon/插件名/Controller/控制器名.php訪問 URL:
https://serverName/Home/info/index/addon/SystemInfo
原本會執行 Home/Controller/InfoController.class.php,
因帶有 addon=SystemInfo,改為執行:
Home/Addon/SystemInfo/Controller/InfoController.class.php
<?php
namespace Home\Addon\SystemInfo\Controller;
class InfoController extends \Think\Controller {
public function index() {
echo 'Addon SystemInfo';
}
}
?>
訪問上述 URL 輸出:Addon SystemInfo
若插件目錄命名為 Plugin,需在配置檔修改:
'VAR_ADDON' => 'plugin'
對應 URL 變為:
https://serverName/Home/info/index/plugin/SystemInfo
Application/
└── Home/
├── Controller/ # 核心控制器
│ └── InfoController.class.php
└── Addon/ # 插件目錄(可配置)
└── SystemInfo/ # 插件名
└── Controller/
└── InfoController.class.php # 同名控制器覆蓋/擴展
模組\Addon\插件名\Controller 命名空間。Think\Controller 以獲得完整框架功能。插件控制器為 ThinkPHP 提供了輕量級的擴展點,善用可大幅降低核心程式碼耦合度。