萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

ThinkPHP 模型實例化的四種方式與最佳實踐

概述

ThinkPHP (3.x/5.x/6.x/8.x) 提供多種模型實例化方式,核心差異在於「是否自定義模型類」、「是否需要跨模塊調用」、「是否需要關聯/事件/範圍查詢」等。本文系統梳理四種方式並給出選型建議。

四種實例化方式

1. 基礎模型: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、無業務邏輯、臨時表、跨模塊表
  • 無需定義模型類文件。
  • 動態解析表名(含前綴)。
  • 不支援自定義方法、訪問器、修改器、關聯、事件。

2. 繼承基礎模型:自定義模型類

<?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']); // 自動觸發修改器加密
  • 業務邏輯封裝在模型內,控制器保持輕量。
  • 支援軟刪除、時間戳自動寫入、字段類型轉換等高級特性。
  • 推薦 90%+ 場景使用。

3. 公共基類模型: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。

4. 空模型/動態表: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();
  • 不綁定具體表,臨時指定表名。
  • 適用於:跨庫查詢、動態表名(分表)、原生 SQL、無模型類的舊表。

TP3 vs TP5/6/8 關鍵差異

特性ThinkPHP 3.2ThinkPHP 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() 臨時指定表

常見錯誤

  1. 控制器中 new Model():繞過容器,依賴注入失效,關聯/事件不生效。請用 model() 助手函數。
  2. 重複實例化:同一請求多次 model('User') 返回同一實例 (容器單例),狀態會殘留。需注意 $user->where(...)->find() 後再用時條件疊加問題,用 $user->where(...)->findOrFail() 鏈式調用避免。
  3. 跨模塊調用:TP6+ 需 model('admin.User') 或 model('\\app\\admin\\model\\User')。

總結

ThinkPHP 模型實例化核心是「約定優於配置」與「容器管理」。默認選擇具體模型類,承載業務邏輯;簡單場景用 db() 直接操作查詢構建器;極少數動態場景用空模型。拒絕在控制器裡寫 SQL,拒絕 new Model(),擁抱依賴注入與單例管理。

copyright © 萬盛學電腦網 all rights reserved