ThinkPHP 分表機制實作：百萬級用戶資料水平切分

場景

單表超過百萬筆資料時，查詢與寫入效能下降。ThinkPHP 內建分表支援，可透過配置自動路由至對應子表（house_member_0~_3）。

模型層配置

<?php
namespace app\common\model;

use think\Model;

class MemberModel extends Model
{
    // 分表配置：依 username 進行 hash 取模 4
    protected $partition = [
        'field' => 'username',
        'type'  => 'md5',
        'num'   => 4,
    ];

    // 取得對應分表的查詢物件
    public function getDao($data = [])
    {
        $data = empty($data) ? request()->post() : $data;
        $table = $this->getPartitionTableName($data);
        return $this->table($table);
    }
}

控制器使用範例

<?php
namespace app\controller;

use app\common\model\MemberModel;
use think\facade\Request;

class MemberController
{
    public function login()
    {
        if (Request::isPost()) {
            $this->validateCsrfToken();

            $dao = (new MemberModel())->getDao();
            $user = $dao->where('username', Request::post('username'))->find();

            return $this->jsonResponse($user ? ['status' => 1, 'data' => $user] : ['status' => 0, 'msg' => '帳號不存在']);
        }
        return view();
    }
}

核心分表邏輯解析（getPartitionTableName）

public function getPartitionTableName($data = [])
{
    if (isset($data[$this->partition['field']])) {
        $field = $data[$this->partition['field']];
        switch ($this->partition['type']) {
            case 'id':
                $step = $this->partition['expr'] ?? 1000000;
                $seq = floor($field / $step) + 1;
                break;
            case 'year':
                $field = is_numeric($field) ? $field : strtotime($field);
                $expr = $this->partition['expr'] ?? date('Y');
                $seq = date('Y', $field) - $expr + 1;
                break;
            case 'mod':
                $seq = ($field % $this->partition['num']) + 1;
                break;
            case 'md5':
                $seq = (ord(substr(md5($field), 0, 1)) % $this->partition['num']) + 1;
                break;
            default:
                if (function_exists($this->partition['type'])) {
                    $fun = $this->partition['type'];
                    $seq = (ord(substr($fun($field), 0, 1)) % $this->partition['num']) + 1;
                } else {
                    $seq = (ord($field[0]) % $this->partition['num']) + 1;
                }
        }
        return $this->getTableName() . '_' . $seq;
    } else {
        // 無分表欄位條件：聯合查詢所有分表（需謹慎使用）
        $tables = [];
        for ($i = 0; $i < $this->partition['num']; $i++) {
            $tables[] = 'SELECT * FROM ' . $this->getTableName() . '_' . $i;
        }
        return '(' . implode(' UNION ALL ', $tables) . ') AS ' . $this->name;
    }
}

分表策略選擇指南

遷移與擴容建議

1. 雙寫遷移：新舊分表邏輯並行，校驗一致後切換。
2. 一致性 Hash：引入中間層（Proxy/ShardingSphere）實現無縫擴容。
3. 唯一鍵處理：分表後全域唯一鍵需額外機制（雪花演算法、UID Generator）。
4. 跨分表查詢：盡量避免；必要時在應用層聚合或引入 ES 同步索引。