萬盛學電腦網

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

ThinkPHP 3.2 CURD 與查詢語法完整速查表(Model、M、select、find、where、表達式、區間、統計、原生 SQL)

ThinkPHP 3.2 作為經典國產框架,其 ORM 操作(CURD)與豐富查詢語法至今仍在大量存量專案中使用。本文系統整理 Model 實例化、新增/刪除/更新/讀取、普通/表達式/區間/統計/原生 SQL 查詢,並附上 fluent 介面鏈式呼叫最佳實踐。

模型實例化

<?php
// 方式一:完整類名(需對應模型類)
$m = new Home\Model\UserModel();
// 方式二:M 快捷函式(無模型類也可用,直接操作表)
$m = M('User'); // 對應 think_user 表(前綴可配置)

一、讀取

方法說明回傳
select()查詢多筆二維陣列 / 空陣列
find($id)查詢單筆(主鍵)一維陣列 / null
getField('field')取單一欄位值字串 / 陣列(多筆時)
getField('id,name')取多欄位組成關聯陣列[id=>name, ...]
$m->select();
$m->find(1);
$m->where('id=2')->getField('username'); // 純量
$m->limit(10)->select(); // 分頁常用

二、新增

$m = M('User');
$m->username = 'ztz2';
$m->email    = 'test@example.com';
$newId = $m->add(); // 回傳自增 ID

// 或陣列批次賦值
$data = ['username' => 'ztz3', 'email' => 'a@b.c'];
$m->data($data)->add();

三、刪除

$m = M('User');
$m->delete(2);                    // 依主鍵刪除
$m->where('id=2')->delete();      // 等效
$m->where('status=0')->delete();  // 條件刪除,回傳影響行數

四、更新

$m = M('User');
$data = ['id' => 1, 'username' => 'ztz2'];
$m->save($data); // 必須包含主鍵,回傳影響行數

// 條件更新
$m->where('id=1')->save(['username' => 'new_name']);

五、查詢語法大全

1. 普通查詢(字串/陣列)

$m->where("sex=0 AND username='gege'")->find(); // 字串
$m->where(['sex'=>0, 'username'=>'gege'])->find(); // 陣列,預設 AND
$m->where(['sex'=>0, 'username'=>'gege', '_logic'=>'or'])->find(); // OR

2. 表達式查詢(核心優勢)

$m->where('id', 'lt', 6)->select();           // id < 6
$m->where('id', ['lt', 6])->select();          // 陣列寫法

// 常用運算子
// EQ/=  NEQ/!=  GT/>  EGT/>=  LT/<  ELT/<=
$m->where('username', 'like', '%ge')->select();
$m->where('username', 'notlike', '%ge%')->select(); // 注意無空格

// 多值 LIKE
$m->where('username', ['like', ['%ge%','%2%','%五%'], 'and'])->select(); // 第三參數指定邏輯

// BETWEEN
$m->where('id', 'between', [5,7])->select();     // 5 <= id <= 7
$m->where('id', 'not between', [5,7])->select(); // 注意空格

// IN / NOT IN
$m->where('id', 'in', [4,6,7])->select();
$m->where('id', 'not in', [4,6,7])->select();

3. 區間查詢(同欄位多條件)

$m->where('id', [['gt',4], ['lt',10]])->select(); // 4 < id < 10 (AND)
$m->where('id', [['gt',4], ['lt',10], 'or'])->select(); // OR

// 複雜組合
$m->where('name', [
    ['like', '%2%'],
    ['like', '%五%'],
    'gege', // 這裡原文有誤,實際第三參數為邏輯
    'or'
])->select();

4. 統計查詢

$m->where('status=1')->count();   // 總數
$m->max('score');                   // 最大值
$m->min('score');                   // 最小值
$m->avg('score');                   // 平均
$m->sum('amount');                  // 總和

5. 原生 SQL

$m = M(); // 無模型
// 查詢
$res = $m->query("SELECT * FROM t_user WHERE id > 50");
// 寫入/更新/刪除
$affected = $m->execute("INSERT INTO t_user(username) VALUES('ztz3')");

進階技巧與避坑

  • 字段映射:模型定義 protected $fields = ['id','username','email']; 可防止大量賦值注入。
  • 自動完成:protected $_auto = [['create_time', 'time', self::MODEL_INSERT, 'function']]; 自動填充時間戳。
  • 事務:$m->startTrans(); ... $m->commit(); / $m->rollback();。
  • 分頁:$m->where(...)->page($page, $size)->select(); 配合 $m->count() 計算總頁數。
  • 避坑:where('id', 'in', []) 空陣列會產生 WHERE id IN () 導致 SQL 語法錯誤,需先判斷非空。

遷移建議

ThinkPHP 3.2 已停止維護(PHP 5.3~7.0),新專案建議遷移至 ThinkPHP 6/8(PHP 7.1+/8.0+),語法相似但底層重構、支援 PSR、依賴注入、中介軟體、嚴格型別,長期維護成本大幅降低。

copyright © 萬盛學電腦網 all rights reserved