ThinkPHP配置TiFlash数据库：HTAP场景下ThinkPHP与列存引擎的智能路由-ThinkPHP-PHP中文网

thinkphp 不直接配置 tiflash，仅通过 sql 行为影响 tidb 的路由决策；需在 tidb 端开启副本、sql 中加 hint 或设会话变量 tidb_isolation_read_engines 才能触发 tiflash 下推。

thinkphp配置tiflash数据库：htap场景下thinkphp与列存引擎的智能路由

ThinkPHP 本身不直接配置 TiFlash，也不参与 TiDB 的智能路由决策；它只是把 SQL 请求原样发给 PDO 或 ThinkPHP 自带的数据库连接层，后续路由由 TiDB Server 根据执行计划、Hint、会话变量或表级别设置自动完成。

TiFlash 不是 ThinkPHP 的「数据库配置项」

TiFlash 是 TiDB 集群中的一个独立列式存储副本组件，和 MySQL 连接参数（如 host、port、database）完全无关。你在 ThinkPHP 的 config/database.php 里填的仍是 TiDB Server 的地址（比如 127.0.0.1:4000），不是 TiFlash 的地址。

常见误解是试图在 ThinkPHP 配置里加 'tiflash' => true 或类似字段——这不会生效，框架根本不识别该配置。

TiDB Server 收到查询后，会基于统计信息、EXPLAIN 结果、是否命中 TiFlash 副本表等判断是否下推到 TiFlash
只有显式启用 TiFlash 副本的表（ALTER TABLE orders SET TIFLASH REPLICA 1），才可能被选中
ThinkPHP 发出的 Db::table('orders')->groupby('user_id')->count() 这类聚合语句，能否走 TiFlash，取决于 TiDB 的优化器，不是 ThinkPHP 控制的

让 ThinkPHP 查询「真正走 TiFlash」的三个可控动作

你不能改 ThinkPHP 的数据库配置来“启用 TiFlash”，但可以控制 SQL 行为，影响 TiDB 的执行计划选择：

对目标表提前开启 TiFlash 副本：ALTER TABLE orders SET TIFLASH REPLICA 1（必须在 TiDB 执行，非 ThinkPHP）
在查询中加 /*+ READ_FROM_STORAGE(TIFLASH[orders]) */ Hint，强制走 TiFlash（ThinkPHP 中可用 Db::raw() 或原生查询注入）
设置会话级变量：SET SESSION tidb_isolation_read_engines = "tiflash";，之后所有兼容查询都会优先选 TiFlash（需在每次连接初始化时执行一次）

例如，在 ThinkPHP 的中间件或 Db 初始化回调中加入：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

Db::execute("SET SESSION tidb_isolation_read_engines = 'tiflash'");

注意：该设置仅对当前连接有效；连接池复用时需确保每次获取连接后重置（或用 after_connect 钩子）。

为什么 `Db::table('orders')->select()` 没走 TiFlash？

最常被忽略的是「单行点查」和「小范围主键查询」根本不会触发 TiFlash。TiFlash 专为大扫描、高基数聚合、时间范围扫描设计，以下情况 TiDB 一定绕过 TiFlash：

WHERE 条件含主键等值查询（如 id = 123）
返回行数预估极少（EXPLAIN 显示 cop[tikv] 而非 cop[tiflash]）
表未设置 TiFlash 副本，或副本状态为 OFFLINE/PENDING（可用 SELECT * FROM information_schema.tiflash_replica 查）
查询含 TiFlash 尚不支持的函数（如某些窗口函数、JSON 函数）