ThinkPHP 3.2 limit() 方法詳解：分頁、截取、寫操作限制與大數據優化策略

掌握 limit() 精準控制結果集大小：從基礎分頁到百萬級優化

limit() 是模型類連貫操作核心方法之一，直接映射 SQL LIMIT 子句。支援單參數（數量）、雙參數（偏移,數量）、字符串 'offset,count' 三種形式，適用於查詢、更新、刪除等所有操作。

基礎語法

$Model = M('Article');

// 單參數：前 N 條
$Model->where('status=1')->limit(10)->select();
// LIMIT 10

// 雙參數：偏移量, 數量 (3.1+ 推薦)
$Model->limit(10, 25)->select();
// LIMIT 10, 25

// 字符串兼容寫法
$Model->limit('10,25')->select();
// LIMIT 10, 25

典型場景：分頁查詢

public function index($page = 1, $pageSize = 15) {
    $page = max(1, (int)$page);
    $offset = ($page - 1) * $pageSize;
    $list = M('Article')
        ->where('status=1')
        ->order('id DESC')
        ->limit($offset, $pageSize)
        ->select();
    return $list;
}

寫操作限制（更新/刪除指定條數）

// 僅更新前 3 條符合條件的記錄
M('User')->where('score=100')->limit(3)->save(['level' => 'A']);

// 僅刪除前 5 條軟刪除標記
M('Log')->where('created_at < "2023-01-01"')->limit(5)->delete();

大數據表優化：游標分頁替代 OFFSET

當表超過百萬行，LIMIT 100000, 20 需掃描並丟棄前 10 萬行，性能急劇下降。解決方案：基於主鍵游標。

// 首頁
$list = M('Article')->where('status=1')->order('id')->limit(20)->select();
$lastId = $list ? end($list)['id'] : 0;

// 翻頁：客戶端傳遞 last_id
$list = M('Article')
    ->where('status=1')
    ->where('id', '>', $lastId) // 或 ->where(['id' => ['GT', $lastId]])
    ->order('id')
    ->limit(20)
    ->select();

優勢：利用主鍵索引直接定位，時間複雜度 O(log n) + O(limit)，與頁數無關。

兼容性說明

• 所有數據庫驅動（MySQL、PostgreSQL、SQLite、SQL Server、Oracle）均透過驅動類自動轉換為對應方言（TOP/ROWNUM/OFFSET FETCH）。
• ThinkPHP 3.2.3+ 完整支援雙參數形式，舊版本僅支援字符串 'offset,count'。

常見誤區

最佳實踐清單

1. 列表頁必加 limit()，防止全表掃描導致 OOM。
2. 分頁參數嚴格型轉換 (int)$_GET['page']，防注入。
3. 百萬級表強制使用游標分頁，禁用 OFFSET。
4. 寫操作加 limit(1) 保護，防誤更新全表。