ThinkPHP 数据库配置文件阿里云 RDS 写法【云】-ThinkPHP-PHP中文网

thinkphp连接阿里云rds需精准配置database.php并适配云特性：普通实例用内网地址、正确权限和utf8mb4编码；serverless实例必须启用rds proxy（会话级池）、禁用pdo持久连接、使用proxy域名；主从分离需开启rw_separate并配置slaves数组；安全上须校验白名单、账号权限及网络连通性。

thinkphp 数据库配置文件阿里云 rds 写法【云】

ThinkPHP 连接阿里云 RDS，核心是把 RDS 的连接信息准确填入配置文件，并适配云环境特性（比如内网访问、安全组、Serverless 冷启动等）。不是简单替换 localhost 就能跑通，尤其在生产环境必须注意地址、权限、连接复用和重连策略。

标准 database.php 配置（适用于普通 RDS 实例）

推荐使用 ThinkPHP 6+ 的 config/database.php 格式，关键字段必须明确：

hostname：填 RDS 实例的内网地址（如 rm-xxxxx.mysql.rds.aliyuncs.com），ECS 同地域部署时务必用内网，延迟低且免费
username / password：RDS 控制台创建的数据库账号（非高权限账号也可，但需授权对应库）
database：已在 RDS 中创建好的具体库名（不是实例名）
hostport：默认 3306，若修改过需同步填写
charset：建议设为 utf8mb4，兼容 emoji 和四字节字符
params：加上 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，便于捕获真实错误

Serverless 实例必须启用 RDS Proxy

RDS Serverless 默认空闲 10 分钟暂停，ThinkPHP 在 CLI 或 Swoole 常驻进程中复用连接时会报 SQLSTATE[HY000] [2002] Connection refused——这不是网络问题，而是实例还在 6~40 秒冷启动中。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

不能靠 'break_reconnect' => true 完全解决（仅对 HTTP 请求有效，CLI 任务仍失败）
必须在 RDS 控制台开通 RDS Proxy，并选择会话级连接池
配置中 hostname 改为 Proxy 域名（形如 your-proxy.rdsproxy.cn-hangzhou.rds.aliyuncs.com）
禁用 PDO 持久连接：'params' => [PDO::ATTR_PERSISTENT => false]，否则与 Proxy 的会话管理冲突
Proxy 账号需在 RDS 中精确授权（不能用 %，建议绑定 ECS 内网 IP 或走安全组白名单）

主从读写分离配置（一主多只读 RDS）

若已部署主 RDS + 多个只读 RDS 实例，ThinkPHP 可原生支持读写分离：

开启 'rw_separate' => true，框架自动将 SELECT 发往从库，其他操作走主库
'master_num' => 1 表示主库数量；'slave_no' => '' 留空则随机选从库，也可指定序号（如 'slave_no' => 0）
从库列表通过 'slaves' 数组定义，每个子数组结构同主库配置，例如：

（示例）

'slaves' => [
    [
        'hostname' => 'rm-xxx-read1.mysql.rds.aliyuncs.com',
        'database' => 'your_db',
        'username' => 'readonly_user',
        'password' => '***',
        'hostport' => 3306,
    ],
    [
        'hostname' => 'rm-xxx-read2.mysql.rds.aliyuncs.com',
        'database' => 'your_db',
        'username' => 'readonly_user',
        'password' => '***',
        'hostport' => 3306,
    ],
]