ThinkPHP 核心方法深度解析：M 方法與 R 方法實戰指南

M 方法：輕量級模型實例化

M() 用於實例化基礎模型類（默認 Think\Model），無需定義模型類文件，減少 IO 加載，性能優於 D()。適用於簡單 CRUD、跨項目調用、數據表超多（100+）但邏輯較簡單的場景。

調用格式

M('[基礎模型名:]模型名', '表前綴', '數據庫連接信息')

核心用法

1. 基礎實例化（操作 think_user 表）

$User = M('User');          // 等效 new Model('User')
$User->select();              // 調用基礎模型方法

2. 指定公共模型類（封裝通用邏輯）

// 實例化 CommonModel:User，等效 new CommonModel('User')
$User = M('CommonModel:User');

CommonModel 需繼承 Model，可定義通用邏輯方法，減少重複建模。

3. 指定表前綴、數據庫、連接信息

// 操作 db2 數據庫的 think_user 表
$User = M('db2.User', 'think_');

// 操作 db1 數據庫的 user 表（無前綴）
$User = M('db1.User', null);

// 自定義連接信息（DSN/數組/配置參數）
$User = M('User', 'think_', 'mysql://user_a:1234@localhost:3306/thinkphp');
$User = M('User', 'think_', 'DB_CONFIG'); // 使用配置參數

// 組合：公共模型 + 數據庫 + 前綴
$User = M('CommonModel:db2.User', 'think_');

4. 分層模型實例化

// 實例化 UserLogic 模型（邏輯層）
M('UserLogic:User');
// 等效 D('User', 'Logic')，但 M 更輕量

關鍵特性

• 單例模式：同一參數多次調用返回同一實例
• 自動轉小寫：模型名自動轉為小寫表名（think_user）
• 無需導入類：框架自動加載

R 方法：跨模塊/控制器操作調用

R() 用於調用任意控制器的操作方法，是 A() 的增強版，支援參數傳遞、跨分組/項目、指定控制器層。

調用格式

R('[項目://][分組/]模塊/操作', '參數數組', '控制器層名稱')

核心用法

1. 基礎調用（同模塊）

// UserAction::detail($id)
class UserAction extends Action {
    public function detail($id) {
        return M('User')->find($id);
    }
}

// 其他控制器中調用
$data = R('User/detail', [5]);  // 返回 id=5 的用戶數據
$data = R('User/detail');       // 無參數調用

2. 跨分組/項目調用

// Admin 分組下的 User 控制器
R('Admin/User/detail', [5]);

// Admin 項目下的 User 控制器
R('Admin://User/detail', [5]);

3. 指定控制器層（推薦架構）

官方建議將公共調用封裝為獨立 API 層，避免邏輯混亂：

// 新增 Api 控制器層
class UserApi extends Action {
    public function detail($id) {
        return M('User')->find($id);
    }
}

// 調用時指定層
$data = R('User/detail', [5], 'Api');

進階特性

• 支援 ACTION_SUFFIX：若配置 'ACTION_SUFFIX'=>'Action'，調用方式不變，自動匹配 detailAction
• 返回值透傳：被調用方法的返回值直接作為 R() 返回值
• 必須 public：被調用方法必須為 public 類型

最佳實踐建議

1. 簡單 CRUD 用 M()：無需建模型類文件，性能最優
2. 複雜業務用 D()：需封裝邏輯、驗證、自動完成時定義模型類
3. 公共邏輯抽離到 Api 層：R('User/detail', [], 'Api')，職責清晰
4. 避免同層過度 R()：導致調用鏈難追蹤，優先考慮 Service 層封裝
5. 跨項目調用謹慎：增加耦合，建議改為 API 服務化（REST/gRPC）

對比總結表