PhpStorm 连接 CentOS 上数据库的实用步骤
一 准备工作
- 在 CentOS 上安装并启动数据库（以 MySQL/MariaDB 为例）：
- 安装：sudo yum install -y mysql-server mariadb-server
- 启动与自启：sudo systemctl start mysqld && sudo systemctl enable mysqld
- 安全初始化（可选）：sudo mysql_secure_installation
- 如需远程连接，开放防火墙端口（以 3306 为例）：
- 使用 firewalld：sudo firewall-cmd --add-port=3306/tcp --permanent && sudo firewall-cmd --reload
- 如使用云服务器，还需在云厂商安全组放行 3306 端口。
二 在 PhpStorm 中新建数据源
- 打开设置：File → Settings（macOS 为 Preferences）→ Languages & Frameworks → PHP → Database（或直接打开右侧 Database 工具窗口）。
- 点击 + → 选择数据库类型（如 MySQL 或 PostgreSQL）。
- 填写连接参数：
- Host：数据库地址（本机可用 localhost 或 127.0.0.1；远程填服务器 IP）
- Port：如 3306（MySQL）、5432（PostgreSQL）
- User / Password：数据库账户凭据
- Database：要连接的库名（可留空，连接后再选）
- 首次使用若提示缺少驱动，点击 Download 自动获取；点击 Test Connection 验证，成功后 OK 保存。
三 远程连接与常见故障排查
- 数据库侧允许远程：
- 修改 MySQL 配置（/etc/my.cnf 或 /etc/mysql/my.cnf）：将 bind-address 改为 0.0.0.0（或注释掉该行），重启：sudo systemctl restart mysqld
- 授权远程账户（示例）：GRANT ALL PRIVILEGES ON . TO ‘root’@‘%’ IDENTIFIED BY ‘YourPassword’ WITH GRANT OPTION; FLUSH PRIVILEGES;
- 服务器与云安全：
- 确保 firewalld/iptables 放行 3306，云主机安全组同样需要放行
- 避免使用弱口令，限制来源 IP 更安全
- 连接失败快速检查：
- 在服务器本机测试：mysql -h 127.0.0.1 -P 3306 -u root -p
- 检查端口监听：ss -tlnp | grep 3306（应看到 0.0.0.0:3306 或 :::3306）
- 若使用宝塔等面板，需在面板里放行 3306 并调整数据库 权限/所有人 设置。
四 常用参数与扩展
- 常用参数一览：
- MySQL：Host（服务器IP/域名）、Port 3306、User、Password、Database（可选）
- PostgreSQL：Host、Port 5432、User、Password、Database
- SSL 连接：在 PhpStorm 的数据库配置中切换到 SSL 选项卡，按需配置 CA/证书/密钥 后测试连接
- PHP 扩展（运行项目时需要，PhpStorm 连接数据库不依赖本地 PHP 扩展）：
- MySQL：sudo yum install -y php php-mysqlnd
- PostgreSQL：sudo yum install -y php php-pgsql
- 修改 php.ini 启用扩展（如 extension=mysqli、extension=pdo_mysql），重启 httpd/php-fpm。