phpenv仅管理PHP版本，不安装Doris；需先用phpenv配置好PHP≥7.4及mysqli扩展，再让PHP连接已独立部署的Doris集群，关键步骤包括验证Doris服务、用户授权、端口连通性，并使用mysqli通过9030端口建立带超时设置的连接。
本身不安装 Doris 数据库，它只管理 PHP 版本。把
和 Doris 混在一起搜，容易走偏——Doris 是独立部署的 OLAP 数据库，PHP 只是它的客户端之一。
你真正需要的是：
用管好 PHP 环境，再让这个 PHP 连上已部署好的 Doris
。下面直说关键动作。
确认 PHP 版本和 mysqli 扩展是否就位
Doris 通过 MySQL 协议通信，所以 PHP 必须启用
（或
），且版本建议 ≥ 7.4（Doris 2.x 对 PHP 8.0+ 兼容更稳）。
先查当前 PHP：
；如果不对，用
切换
查扩展是否加载：
；没输出就说明没装
Debian/Ubuntu 装扩展：
CentOS/RHEL：
（注意 PHP 版本匹配，如
）
装完重启 Web 服务（如 Apache）或 CLI 重载（
再确认）
连接 Doris 前必须验证的三件事
很多“连不上”的问题其实卡在 Doris 侧，而不是 PHP 代码。
立即学习
“
PHP免费学习笔记（深入）
”；
容器或进程是否在运行？检查端口：
或
Doris 用户是否创建并授权？执行过类似 SQL 吗：
防火墙/安全组是否放行 9030？特别是 Docker 宿主机网络模式下，
的
映射要明确写
mysqli 连接 Doris 的最小可运行代码
别一上来就写类、封装连接池，先跑通最简连接。注意 Doris 的 MySQL 协议端口是
，不是 MySQL 默认的 3306。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
⚠️ 注意：
是关键，Doris 查询可能耗时较长，不设这个值，PHP 会等默认的 60 秒（甚至更久），而 nginx/Apache 可能先超时断开。
为什么不用 PDO_MySQL？
可以，但要注意两个坑：
必须设为
，否则 Doris 返回的语法错误（比如不支持的函数）会被静默忽略
Doris 不支持所有 MySQL 函数，例如
、
（部分版本）、
，PDO 不报错但结果为空或报错码 1105，得看
里的具体提示
如果你用 Laravel，DBAL 层默认用 PDO，建议在
的
配置里加
复杂 OLAP 场景下，
更透明，出错时
和
直接对应 Doris 的错误码（如 1105 表示语法不支持，2013 表示连接中断），调试更快。
phpenvphpenvphpenvmysqliPDO_MySQLphp -vphpenv global 8.1.10php -m | grep mysqlisudo apt-get install php-mysqlisudo yum install php-mysqliphp81-php-mysqliphp -mdoris-fenc -zv doris_fe 9030telnet doris_fe 9030CREATE USER 'php_app'@'%' IDENTIFIED BY 'xxx'; GRANT SELECT ON php_db.* TO 'php_app'@'%';docker-compose.ymlports"9030:9030"9030$conn = new mysqli($host, $user, $pass, $db, $port);if ($conn->connect_errno) {
die("连接失败（" . $conn->connect_errno . "）: " . $conn->connect_error);
}
// 必须设置超时，否则慢查询可能卡死整个 PHP 进程
$conn->options(MYSQLI_OPT_CONNECT_TIMEOUT, 5);
$conn->options(MYSQLI_OPT_READ_TIMEOUT, 30);
$conn->set_charset('utf8mb4');
$result = $conn->query("SELECT COUNT(*) FROM user_behavior");
if ($result) {
list($cnt) = $result->fetch_row();
echo "共 {$cnt} 条记录\n";
}
$conn->close();
?>
MYSQLI_OPT_READ_TIMEOUTPDO::ATTR_ERRMODEPDO::ERRMODE_EXCEPTIONJSON_EXTRACTGROUP_CONCATINSERT ... ON DUPLICATE KEY UPDATE$e->getMessage()config/database.phpmysql'options' => [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]mysqli$conn->error$conn->errno