在 CentOS 上配置 PhpStorm 数据库连接
一 前置准备
- 确保数据库服务已安装并运行(示例为 MySQL/MariaDB 或 PostgreSQL),并设置为开机自启:
- MySQL/MariaDB
- 安装:sudo yum install mariadb-server mariadb
- 启动与自启:sudo systemctl start mariadb && sudo systemctl enable mariadb
- PostgreSQL
- 安装:sudo yum install postgresql-server
- 初始化并启动:sudo postgresql-setup initdb && sudo systemctl start postgresql && sudo systemctl enable postgresql
- 如为远程数据库,需允许远程访问(例如修改数据库配置文件中的绑定地址、启用远程用户权限),并确保 防火墙放行数据库端口(如 3306/5432)。以上准备完成后,再在 PhpStorm 中建立连接会更顺利。
二 在 PhpStorm 中新建数据源
- 打开设置:File > Settings(Linux)或 PhpStorm > Preferences(macOS),进入 Languages & Frameworks > PHP > Database(或直接打开右侧 Database 工具窗口)。
- 点击 + 新建数据源,选择数据库类型(如 MySQL 或 PostgreSQL)。
- 填写连接参数:
- Host:数据库主机地址(本机可用 localhost 或 127.0.0.1,远程填服务器 IP/域名)
- Port:如 3306(MySQL/MariaDB)、5432(PostgreSQL)
- User / Password:具有相应权限的数据库账号与密码
- Database:要连接的数据库名(可留空,连接后再选)
- 需要时配置 SSL 选项
- 点击 Test Connection 验证,成功后点击 OK/Apply 保存。
三 常见故障排查
- 服务与网络
- 确认数据库服务处于 active (running) 状态:sudo systemctl status mariadb 或 sudo systemctl status postgresql
- 远程连接时,检查服务器防火墙是否放行对应端口(如 3306/5432),以及云主机安全组规则是否允许来源 IP 访问
- 数据库权限与绑定
- 确保数据库用户具备从 PhpStorm 所在主机访问的权限(例如 MySQL 的授权语句包含正确的 host)
- 如仅本机可连,检查数据库是否仅绑定 127.0.0.1,需要远程访问时应调整为 0.0.0.0 或指定网段
- 客户端驱动
- PhpStorm 通常自带常见数据库的 JDBC/驱动,无需额外安装;若提示缺少驱动,按界面指引下载并配置即可。
四 常用参数速查表
| 项目 |
MySQL/MariaDB |
PostgreSQL |
| 默认端口 |
3306 |
5432 |
| 安装包示例 |
mariadb-server、mariadb |
postgresql-server |
| 服务名 |
mariadb |
postgresql |
| 常用主机填写 |
localhost / 服务器IP |
localhost / 服务器IP |
以上参数与命令示例可直接用于快速核对与配置。