在 CentOS 上配置 PhpStorm 数据库连接
一 准备工作
- 确认数据库已安装并运行：在 CentOS 上安装 MySQL/MariaDB 或 PostgreSQL，启动并设置开机自启；如使用 MySQL，建议执行 mysql_secure_installation 完成安全初始化。
- 确保数据库监听正确：本地连接可用 localhost/127.0.0.1；远程连接需将数据库配置为监听外部地址，并开放防火墙端口（如 3306/5432）。
- 准备数据库账号与权限：为 PhpStorm 创建专用用户并授予目标库权限（避免使用 root 远程连接）。
- 安装数据库驱动：在 PhpStorm 中首次连接时下载缺失的 JDBC/驱动文件（如 MySQL、PostgreSQL）。
- 说明：PhpStorm 自带数据库工具窗口，无需在服务器安装 PHP 扩展即可连接数据库；PHP 扩展仅用于运行项目代码与调试。
二 在 PhpStorm 中新建数据源
- 打开设置：依次进入 File > Settings > Languages & Frameworks > PHP > Database（macOS 为 Preferences）。
- 新建连接：点击 +，选择 Data Source，再选择 MySQL 或 PostgreSQL。
- 填写连接参数：设置 Host（主机名/IP）、Port（如 3306/5432）、Database（目标库名）、User、Password；如需加密，配置 SSL。
- 下载驱动：若提示缺少驱动，点击 Download missing driver files。
- 测试与保存：点击 Test Connection，成功后 OK 保存。
三 常见连接场景与参数
| 场景 |
主机与端口 |
必要配置 |
备注 |
| 本机数据库 |
localhost / 127.0.0.1 : 3306(MySQL) 或 5432(PG) |
使用有权限的数据库用户 |
仅本机可连，最省事 |
| 远程数据库 |
服务器公网/内网 IP : 3306/5432 |
数据库需允许远程、开放防火墙、用户具备远程权限 |
生产常用 |
| 容器/虚拟机 |
宿主机 IP : 3306/5432 |
容器端口映射正确、宿主机防火墙放行 |
注意网络模式与端口 |
| SSL 加密 |
同上 |
在 PhpStorm 启用 SSL 并配置证书 |
云数据库常见要求 |
四 连接失败排查清单
- 服务状态：确认数据库服务已启动（如 mysqld/postgresql），必要时查看日志定位启动失败原因。
- 网络与防火墙：服务器防火墙放行 3306/5432；云主机安全组规则允许来源 IP。
- 监听地址：数据库配置应监听 0.0.0.0（或指定网卡），而非仅 127.0.0.1。
- 用户权限：确保数据库用户允许从 PhpStorm 所在主机连接（如
'user'@'%' 或指定网段）。
- 驱动与参数：驱动未下载或版本不匹配会导致连接失败；核对 Host/Port/Database/User/Password/SSL。
- 错误提示：根据 PhpStorm 报错信息逐项核对，例如“Connection refused/Access denied/SSL handshake failed”。
五 常用操作与后续
- 在 Database 工具窗口执行 SQL、浏览与编辑表数据、导出/导入数据、版本控制集成等。
- 若需管理多环境（开发/测试/生产），可创建多个 Data Source 并在不同运行配置间切换。