在 Ubuntu 上配置 PHPStorm 数据库连接
一 准备工作
- 安装数据库服务器（以 MySQL 为例）：sudo apt update && sudo apt install mysql-server；完成后执行 sudo mysql_secure_installation 进行安全初始化。
- 确保数据库服务已启动：sudo systemctl start mysql；如需开机自启：sudo systemctl enable mysql。
- 如需远程连接，请确认云/机房安全组或本机防火墙已放行 3306 端口。
- 在 PHPStorm 中首次使用数据库工具时，若提示缺少驱动，点击 Download 自动安装对应驱动（如 MySQL Connector/J）。
二 在 PHPStorm 中添加数据源
- 打开设置：File > Settings（macOS 为 PhpStorm > Preferences）。
- 进入：Languages & Frameworks > PHP > Database（或 View > Tool Windows > Database，点击 + 新建数据源）。
- 选择数据库类型（如 MySQL、PostgreSQL 等）。
- 填写连接参数：
- Host：localhost 或服务器 IP
- Port：如 3306
- User / Password：数据库账户
- Database：要连接的库名（可留空以显示全部库）
- 点击 Test Connection 验证；成功后 OK 保存。
三 本地与远程连接的关键设置
- 本地连接：Host 填 localhost，Port 3306，使用具备相应权限的数据库用户。
- 远程连接：
- 修改 MySQL 配置：编辑 /etc/mysql/mysql.conf.d/mysqld.cnf，将 bind-address 改为 0.0.0.0（或注释掉该行），然后重启：sudo systemctl restart mysql。
- 在数据库中授予远程权限（示例）：
- CREATE USER ‘dev’@‘%’ IDENTIFIED BY ‘StrongPass!’;
- GRANT ALL PRIVILEGES ON . TO ‘dev’@‘%’ WITH GRANT OPTION;
- FLUSH PRIVILEGES;
- 确保服务器防火墙放行 3306（UFW：sudo ufw allow 3306）。
四 常见问题排查
- 连接失败先检查服务是否运行：sudo systemctl status mysql；必要时重启。
- 出现 “Access denied”：核对用户名/密码、主机限制（‘%’ 或具体 IP）、是否执行了 FLUSH PRIVILEGES。
- 远程连不通：确认 bind-address、云安全组/本机防火墙已放行 3306，以及用户授权为远程主机。
- 驱动问题：在数据源界面点击 Download 安装或更新驱动。
- 时区/SSL：如出现时间或握手错误，可在数据源属性中设置 Server Timezone（如 UTC 或 Asia/Shanghai）及 SSL 选项。
五 常用后续操作
- 在 Database 工具窗口浏览 表/视图，右键表选择 New > Query Console 执行 SQL。
- 可使用代码自动完成、语法高亮、数据编辑与导出等数据库工具功能。
- 建议定期更新 PHPStorm 与数据库驱动，保持兼容性与稳定性。
