如何配置ThinkPHP8.1分布式下数据库分表规则-ThinkPHP-PHP中文网

thinkphp 8.1 不支持自动分表，需手动计算表名并动态切换；分布式部署（主从读写分离）与分表逻辑正交，须先配置 deploy=1 和 rw_separate=true，再通过 db::table() 或重写 model::gettable() 实现分表。

如何配置thinkphp8.1分布式下数据库分表规则

ThinkPHP 8.1 **不支持内置的自动分表规则（如 `partition` 配置或 `partition()` 方法）**，官方早在 6.0 就移除了该功能，8.1 完全依赖手动控制表名。所谓“分布式下的分表”，其实是两个独立问题的叠加：**数据库部署是分布式的（如主从读写分离）**，而**分表是业务层按规则动态选表**，两者无自动联动。下面直接说清楚怎么配、怎么用、关键避坑点：

一、先确认你真需要分表，而不是优化或读写分离

分表是重量级改造，不是性能调优首选。满足以下至少两项再考虑：

单表数据量持续超过 2000 万行，且每日新增超 50 万
B+ 树索引深度明显变大，EXPLAIN 显示 key_len 异常、type=ALL 频发
写入瓶颈已无法通过连接池、批量插入、异步落库缓解

如果只是查询慢，优先加索引、用缓存、拆字段、做读写分离——TP8.1 的 deploy=1 + rw_separate=true 已能解决大部分读压力。

二、分布式配置（主从集群）本身不涉及分表，但必须先配好

在 config/database.php 中启用部署模式，这是分表前的基础设施：

'connections' => [
    'mysql' => [
        'deploy'       => 1,           // 启用分布式
        'rw_separate'  => true,        // 读写分离
        'hostname'     => [
            'write' => ['master1:3306', 'master2:3306'],
            'read'  => ['slave1:3306', 'slave2:3306']
        ],
        'database'     => 'myapp_db',
        'username'     => 'app_user',
        'password'     => '***',
        'charset'      => 'utf8mb4',
        'prefix'       => 't_',
    ]
]

注意：这个配置只决定SQL往哪个节点发，完全不影响表名。哪怕你查 t_user_202410，框架仍会根据读写规则把请求路由到从库或主库——分表逻辑和分布式路由是正交的。

三、真正的分表：手动计算表名 + 动态切换

TP8.1 没有 magic 分表，只有两种可靠方式：

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

查询构造器方式：用 Db::table($tableName) 替代 Db::name('user')
模型方式：继承 Model，重写 getTable() 方法，根据参数/时间/ID 返回具体表名

例如按月分表日志：

// 控制器中
$month = $this->request->param('month', date('Ym')); // 如 202410
if (!preg_match('/^\d{6}$/', $month)) {
    throw new HttpException(400, '非法表后缀');
}
$tableName = 'log_' . $month;

$data = Db::table($tableName)
    ->where('create_time', '>=', $month . '01')
    ->where('create_time', 'select();

关键细节：

表名校验必须做，否则可能拼出 log_;DROP TABLE users 类注入风险
时间字段查询不能只靠 where('create_time', '2024-10-15')，必须配合表名语义——框架不会跨表扫描
时区要统一：PHP date() 和 MySQL NOW() 时区不一致会导致错表（建议全部用 UTC 或显式设 date_default_timezone_set('Asia/Shanghai')）