ThinkPHP CURD 操作速查表：鏈式查詢、聚合、原生 SQL 執行

ThinkPHP CURD 操作速查表

ThinkPHP (3.x/5.x/6.x/8.x) 核心模型方法高度一致。本文匯總最常用的增刪改查、鏈式操作、聚合統計、原生 SQL 執行，適合貼在工位速查。

查詢 (返回二維陣列)

// 全部
User::select();
// 條件
User::where('id', '>', 2)->select();
// 排序+分頁+字段
User::where('id', '>', 2)
    ->order('id desc')
    ->limit(0, 5)
    ->field('id,username,email')
    ->select();
// 分組+Having
User::where('id', '>', 2)
    ->group('department_id')
    ->having('count(*) > 3')
    ->select();

單條查詢 (返回一維陣列/模型)

User::find();           // 主鍵查詢
User::where('id', 2)->find();
User::where('email', 'a@b.com')->find();

新增 (返回自增 ID 或影響行數)

$data = ['username' => 'wang', 'password' => '123456'];
User::create($data);           // 返回模型實例 (含 id)
User::insert($data);           // 返回影響行數
User::insertAll([...]);        // 批量插入

刪除 (返回影響行數)

User::destroy(2);              // 主鍵刪除
User::where('id', 2)->delete();
User::where('status', 0)->delete();

修改 (返回影響行數)

$data = ['username' => 'wang_new', 'password' => 'newpass'];
User::where('id', 2)->update($data);
// 或模型實例更新
$user = User::find(2);
$user->username = 'wang_new';
$user->save();

聚合統計

User::count();                    // 總數
User::where('status', 1)->count();
User::max('age');
User::min('score');
User::avg('price');
User::sum('amount');

原生 SQL 執行 (Db 門面)

// 查詢 (返回二維陣列)
Db::query("SELECT * FROM user u JOIN profile p ON u.id=p.user_id WHERE u.id > ?", [10]);

// 寫入 (返回影響行數)
Db::execute("INSERT INTO log (msg, time) VALUES (?, ?)", ['login', time()]);
Db::execute("UPDATE user SET login_count = login_count + 1 WHERE id = ?", [5]);
Db::execute("DELETE FROM cache WHERE expire < ?", [time()]);

常用鏈式方法速查

調試 SQL

// 獲取最後執行的 SQL
echo User::getLastSql();
// 或開啟配置
// 'database' => ['debug' => true] // 日誌記錄所有 SQL