在 CentOS 上使用 PhpStorm 连接数据库
一 准备工作
- 确认数据库已安装并运行（以 MySQL/MariaDB 为例）：
- 安装：sudo yum install -y mysql-server 或 sudo yum install -y mariadb-server
- 启动并设置开机自启：sudo systemctl start mysqld；sudo systemctl enable mysqld
- 可选安全初始化：sudo mysql_secure_installation
- 如需远程连接，放行防火墙端口（示例为 3306）：sudo firewall-cmd --add-port=3306/tcp --permanent && sudo firewall-cmd --reload
- 注意：PhpStorm 作为 IDE 通过 JDBC/原生驱动直连数据库，通常不需要在 CentOS 上额外安装 PHP 数据库扩展（如 php-mysql）；这些扩展仅用于 PHP 运行时。
二 在 PhpStorm 中新建数据源
- 打开 Database 工具窗口：View → Tool Windows → Database
- 新增数据源：点击 + → Data Source → 选择 MySQL（或 PostgreSQL）
- 填写连接参数：
- Host：数据库主机名或 IP
- Port：3306（MySQL）、5432（PostgreSQL）
- Database：要连接的库名（可留空以查看全部库）
- User / Password：数据库账号与密码
- 驱动下载：若提示缺少驱动，点击 Download 自动获取
- 测试与保存：点击 Test Connection，成功后 OK 保存
- 常用操作：在 Database 面板可浏览库表、执行 SQL、对表数据进行增删改查与结构变更（双击表、右键菜单等）
三 远程连接与安全配置要点
- MySQL/MariaDB
- 允许远程：编辑配置文件（如 /etc/my.cnf 或 /etc/my.cnf.d/mysql-server.cnf），将 bind-address 改为 0.0.0.0 或注释该行，重启服务：sudo systemctl restart mysqld
- 授权用户远程访问（示例）：CREATE USER ‘dev’@‘%’ IDENTIFIED BY ‘StrongPass!’; GRANT ALL ON your_db.* TO ‘dev’@‘%’; FLUSH PRIVILEGES;
- PostgreSQL
- 修改 postgresql.conf 的 listen_addresses = ‘*’
- 在 pg_hba.conf 为远程网段添加条目（如 host all all 0.0.0.0/0 md5），重启服务
- 防火墙：确保数据库端口（如 3306/5432）对 PhpStorm 所在主机开放
- 安全建议：避免使用 root 远程；限制来源网段；使用强密码与最小权限
四 常见故障排查
- Test Connection 失败
- 服务未启动：systemctl status mysqld / postgresql
- 端口不通：ss -lntp | grep 3306；或在本机尝试 mysql -h 目标IP -P 3306 -u 用户 -p
- 防火墙/云安全组未放行：放行 3306/5432
- 用户权限或来源限制：检查用户主机限制（如 ‘user’@‘localhost’ 无法远程）
- 驱动问题：在数据源面板点击 Download 重新获取驱动
- 参数错误：确认 Host/IP、Port、Database、User、Password 正确；PostgreSQL 默认数据库为 postgres
- 编码/时区：必要时在 Advanced/Properties 中设置 characterEncoding=UTF-8、serverTimezone=UTC 等参数