ThinkPHP (3.x/5.x/6.x/8.x) 提供多種模型實例化方式,核心差異在於「是否自定義模型類」、「是否需要跨模塊調用」、「是否需要關聯/事件/範圍查詢」等。本文系統梳理四種方式並給出選型建議。
M('table') / model('table')// TP3/5/6/8 通用
$user = M('user'); // TP3/5
$user = model('user'); // TP6/8 (推薦)
// 等價於 new \think\Model(); $user->table('user');
// 適用:簡單 CRUD、無業務邏輯、臨時表、跨模塊表
<?php
// app/model/User.php (TP6/8 命名空間)
namespace app\model;
use think\Model;
class User extends Model {
// 定義表名(可省略,按命名約定自動推斷)
protected $table = 'user';
// 訪問器:獲取時自動處理
public function getStatusAttr($value) {
return ['0' => '禁用', '1' => '正常', '2' => '封禁'][$value] ?? '未知';
}
// 修改器:寫入時自動處理
public function setPasswordAttr($value) {
return password_hash($value, PASSWORD_DEFAULT);
}
// 關聯
public function orders() {
return $this->hasMany(Order::class);
}
}
// 使用
$user = model('User'); // 或 new User()
$user->find(1)->status; // 自動觸發訪問器返回 '正常'
$user->save(['password' => '123456']); // 自動觸發修改器加密
CommonModel<?php
// app/model/CommonModel.php
namespace app\model;
use think\Model;
class CommonModel extends Model {
// 通用作用域:只查未刪除
public function scopeNormal($query) {
return $query->where('delete_time', null);
}
// 通用方法
public function getCreatorName() { ... }
}
// 子模型繼承
class User extends CommonModel { ... }
class Article extends CommonModel { ... }
// 實例化
$user = model('User'); // 繼承了 CommonModel 能力
baseModel。M() / model() 無參數$db = M(); // 或 model()
// 直接執行 SQL
$list = $db->query("SELECT * FROM wp_users WHERE status = 1");
// 或使用查詢構建器
$list = $db->table('wp_users')->where('status', 1)->select();
| 特性 | ThinkPHP 3.2 | ThinkPHP 5/6/8 |
|---|---|---|
| 助手函數 | M('user'), D('user') | model('user'), db('user') |
| 模型類命名空間 | 無 (CommonModel.class.php) | app\model\User |
| 自動加載 | import() / 自動加載不完善 | Composer PSR-4 完美支援 |
| 查詢構建器 | Model 類方法 | 獨立 Query 類,Model 代理 |
| D() 方法 | 自動檢測模型類,不存在拋異常 | 已移除,統一用 model() |
需要自定義業務邏輯/訪問器/關聯?
├─ 是 → 定義具體模型類 (User extends Model) → model('User')
└─ 否
需要通用邏輯 (軟刪除、審計)?
├─ 是 → 定義 CommonModel → 具體模型繼承 CommonModel
└─ 否
固定表、純 CRUD?
├─ 是 → M('table') / db('table')
└─ 否 (動態表/跨庫/原生 SQL) → M() / db() 臨時指定表
model() 助手函數。model('User') 返回同一實例 (容器單例),狀態會殘留。需注意 $user->where(...)->find() 後再用時條件疊加問題,用 $user->where(...)->findOrFail() 鏈式調用避免。model('admin.User') 或 model('\\app\\admin\\model\\User')。ThinkPHP 模型實例化核心是「約定優於配置」與「容器管理」。默認選擇具體模型類,承載業務邏輯;簡單場景用 db() 直接操作查詢構建器;極少數動態場景用空模型。拒絕在控制器裡寫 SQL,拒絕 new Model(),擁抱依賴注入與單例管理。