TP5.1 怎么实现动态表名？模型构造函数与查询构建器技巧【分表】

说实话，TP5.1 的 partition() 方法，在绝大多数场景下就是个摆设。ORM 查询构建器（Query 类）根本不会去解析你传进去的配置。所谓的“动态分表”，核心就两条路：要么手动算表名，然后重写 getTable()；要么直接用 Db::table() 硬写。而且，写入和查询的逻辑必须严格一致，否则数据一跨月就全乱了。

很多开发者遇上 partition() 方法，第一反应是“这玩意儿应该能用吧”。实际上，它只在极少数旧驱动路径中被浅层读取过，ORM 查询构建器根本不认。所以，想实现动态分表，别指望它，老老实实手动算表名，然后显式切换。

重写 getTable() 才是唯一靠谱的入口

模型表名最终由 getTable() 方法决定。这是你唯一能稳定拦截并修改表名的地方。别指望构造函数传参、protected $table 赋值或者配置项——这些在查询执行前就已经固化死了。

• getTable() 在每次查询前都会被调用，包括 select()、insert()、update() 等所有操作。
• 如果按 ID 分表，可以在方法里读取待插入/查询数据的 id 字段。注意：新增时 id 可能还没生成，需要结合 insertGetId() 或者预生成逻辑来处理。
• 如果按时间分表，应该从 $this->data 或查询条件（比如 $this->getOptions('where')）中提取时间字段值，再格式化成后缀。例如：'log_' . date('Ym', strtotime($timeValue))。
• 别忘了校验后缀合法性，避免拼出 log_../etc/passwd 这种非法表名。建议用白名单过滤或者正则断言：preg_match('/^\d{6}$/', $suffix)。

Db::table() 是最直接省事的绕过方式

如果模型逻辑比较复杂，或者只有某几个接口需要分表，干脆放弃继承模型，直接用查询构建器，思路更清晰、控制也更直接。

• 先算出目标表名：$tableName = 'order_' . date('Ym', strtotime($dateParam));
• 然后调用：Db::table($tableName)->where('user_id', 123)->select();
• 注意：这种方式下，模型的获取器（accessor）、修改器（mutator）、自动时间戳等特性都用不了，字段处理得自己补全。
• 如果还想保留模型能力，可以临时绑定：(new OrderModel())->table($tableName)->where(...)->select()。但前提是 OrderModel 里没有硬编码 $table。

partition() 调用后没报错却查错表？这是设计如此

partition() 在 TP5.1 的 Query 类里确实存在，但它只在特定条件下才会触发：必须同时满足「当前有 where 条件包含分表字段」+「规则匹配成功」+「未开启联合查询 fallback」。多数情况下它静默失败，然后回退到主表。

• 常见误用：Model::partition(['id' => 100])->where('status', 1)->select() —— 这里 id 根本不在 where 里，partition() 直接忽略。
• 即使写成 where('id', 100)->partition(...)，如果规则中 type 为 mod 且 num 为 3，它只会生成 table_1、table_2、table_3。但实际表可能是 table_001、table_002，后缀不匹配照样查不到。
• 这个方法内部不校验目标表是否存在，也不会抛异常。错误表现就是“查不到数据”或“查到空结果”，很容易被误判成业务逻辑问题。

真正难的不是算表名，而是保持写入与查询逻辑严格一致。举个例子：按月分表，写入时用 date('Ym', $create_time)，查询时却用了 date('Ym', time())，跨月时必然漏数据。所有时间计算必须基于同一字段、同一时区、同一格式化逻辑，千万别依赖 PHP 默认时区或者数据库时区自动转换。