thinkphp 不支持开箱即用的分库分表,partition() 方法已失效;需手动计算表名并校验输入,动态切换须在 initialize() 或 db::connect() 中实现,跨表查询应由 php 合并结果。

ThinkPHP 本身不提供开箱即用的分库分表能力,所有分片逻辑必须由应用层显式控制——你得在查询发起前就决定连哪个库、查哪张表,否则 ORM 默认只会操作配置里的默认库和默认表名。
为什么 Db::name('user')->partition() 没效果
ThinkPHP 6.x 已完全移除 partition() 方法支持;5.x 虽保留该方法签名,但内部不解析任何分片规则,调用后仅原样返回当前表名,不会自动切表、也不会推导时间后缀或哈希值。常见现象是 SQL 执行成功,但查的仍是 user 表,而非预期的 user_202401。
根本原因:框架不介入表名路由,partition() 不是中间件,也不挂钩查询构建流程。它只是个空壳,别依赖。
如何安全地动态切换分表(按月/按ID)
必须手动计算表名,并通过 table() 或重写 getTableName() 注入。关键点不是“怎么写”,而是“在哪写”和“怎么防”:
- 在模型的
initialize()中根据参数(如$this->year_month)设置$this->table = 'log_' . $this->year_month;,而非在where()后硬拼 - 若用
Db::name(),必须先校验后缀:preg_match('/^\d{6}$/', $suffix),只接受202401这类格式,拒绝202401; DROP TABLE或..%2fetc%2fpasswd - 禁止把用户输入直接拼进表名:
Db::name('order_' . $_GET['month'])是高危操作,PDO 不会参数化表名,等于裸奔 - 建表时统一用
DATETIME类型存时间,且每张分表都单独为create_time建索引——否则 MySQL 无法做分区裁剪,查log_202401仍可能扫全表
跨分表聚合查询只能靠 PHP 合并
想查“最近三个月订单总数”,不能指望 UNION ALL 自动优化。ThinkPHP 的 union() 不支持跨物理表嵌套,MySQL 对多表 UNION 的索引利用也极差。
正确做法是:用循环分别查 order_202401、order_202402、order_202403,再在 PHP 层 array_sum() 或累加计数。实测比单条 UNION 快 2–5 倍,还方便加 Redis 缓存结果。
注意:每次查询都要走独立连接和预处理,别复用同一个 Query 实例改表名——状态容易污染,尤其在协程或长生命周期容器中。
分库必须自己管理连接切换
ThinkPHP 支持多数据库配置(db_partitions),但不会自动路由。你要在模型里重写 getConnection(),或在业务层显式指定连接名:Db::connect('db1')->table('user')->select()。
更常见的做法是封装一个 ShardingDB 工具类,根据分片键(如 user_id)计算目标库名,再调用 Db::connect($dbName)。别试图在中间件里全局切换,不同请求的分片键不同,状态极易错乱。
如果已上 ShardingSphere-Proxy,请把 PHP 的数据库连接地址指向 Proxy(如 host=127.0.0.1:3307),此时所有 SQL 都面向逻辑库和逻辑表写,Db::name('user') 即可,但必须确保所有查询都带分片键条件,且禁用 PDO::ATTR_EMULATE_PREPARES。
最容易被忽略的是时区一致性:PHP 的 date('Ym') 和 MySQL 的 NOW() 可能因时区不同导致跨月错表,上线前务必用 UTC 时间戳对齐。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











