ThinkPHP连接Doris必须使用'mysql'驱动类型，因Doris兼容MySQL协议，可直接通过PDO_MySQL扩展连接，无需额外安装Doris专用驱动。
ThinkPHP 能直接连 Doris，但不能照搬 MySQL 配置——关键在驱动、端口、协议兼容性上卡住的人最多。
ThinkPHP 用什么驱动连 Doris？
必须用 mysql 驱动类型，不是 doris 或其他自定义驱动。Doris 兼容 MySQL 协议，ThinkPHP 的 PDO_MySQL 扩展可直连，无需额外安装 Doris 专用驱动。
-
type必须设为'mysql'，设成'doris'或留空会 fallback 到默认 mysql 驱动但可能因参数不匹配失败 - 不要尝试装
pydoris或apache-doris-client—— 这些是 Python/Java 生态的，对 ThinkPHP 无效 - 确认 PHP 已启用
pdo_mysql和mysqli扩展（php -m | grep mysql可验证）
database.php 配置里哪些参数必须改？
Doris 的 FE 查询端口是 9030，不是 MySQL 默认的 3306；且 root 用户默认无密码，但生产环境必须换专用用户。
-
hostname填 Doris FE 地址，如'192.168.1.100'或'doris-fe.example.com' -
hostport必须显式设为9030，不写会走 PDO 默认 3306，连不上 -
username/password推荐用 Doris 侧创建的专用账号（如'php_app'），避免用root+ 空密码 -
database填 Doris 中已存在的 database 名（如'olap_db'），该库需提前用CREATE DATABASE olap_db;建好 -
charset设为'utf8mb4'，Doris 1.2+ 完全支持，比utf8更稳妥
连接测试失败常见报错和解法
报错不是“数据库不存在”，而是连接层或协议层拒绝——多数因端口、用户权限或协议细节不匹配。
立即学习“PHP免费学习笔记（深入）”；
-
SQLSTATE[HY000] [2002] Connection refused：检查hostport是不是写成了3306，或 Doris FE 没在监听该 IP:9030 -
Access denied for user 'xxx'@'yyy'：Doris 里没给该用户对应 host 的权限，执行GRANT SELECT ON olap_db.* TO 'php_app'@'%'; FLUSH PRIVILEGES; -
Unknown database 'xxx'：database配置名与 Doris 中实际库名大小写/拼写不一致（Doris 库名区分大小写） - 查询返回空数组但无报错：确认表引擎是
OLAP（非MySQL或ES外部表），ThinkPHP 的Db::table('t')->select()只能查内部表
DSN 方式动态连接更灵活，但要注意字符编码
临时查 Doris、或需切换多个 Doris 数据源时，Db::connect() + DSN 比改配置文件更快，但 DSN 字符串里字符集必须显式声明。
- 正确写法：
Db::connect('mysql://php_app:YourPass123@192.168.1.100:9030/olap_db#utf8mb4') - 错误写法：
'mysql://.../olap_db'（缺#utf8mb4），可能导致中文乱码或插入失败 - 用户名/密码含
@、/等特殊字符时，必须先urlencode()，否则 DSN 解析错位 - DSN 连接不走
database.php全局配置，所有参数都得塞进字符串里，漏掉:9030就又连回 3306
真正容易被忽略的是 Doris 的 catalog 模型——ThinkPHP 当前所有连接方式都只认 internal catalog，如果要用 external catalog（比如 Hive、Iceberg 表），必须通过 doris:// 协议 + SQLAlchemy URI，这已经超出 ThinkPHP 原生能力范围，得自己封装 PDO 连接或换 Superset 类工具。
