Ubuntu如何配置PHPStorm的数据库工具

Ubuntu下配置 PhpStorm 数据库工具

一 准备工作

• 安装数据库服务器（以 MySQL 为例）：sudo apt update && sudo apt install mysql-server；完成后执行 sudo mysql_secure_installation 进行安全初始化。若本机作为客户端连接远程库，建议安装客户端：sudo apt-get install mysql-client。如使用 PostgreSQL，可安装 sudo apt-get install postgresql-client。这些客户端库有助于驱动与连接可用性。

二 在 PhpStorm 中添加数据源

• 打开 Database 工具窗口：View → Tool Windows → Database；或 File → Settings → Languages & Frameworks → PHP → Database。点击 + → Data Source → 选择数据库类型（如 MySQL、PostgreSQL）。在弹窗中填写 Host、Port、Database、User、Password，点击 Test Connection 验证；若提示缺少驱动，点击 Download 自动安装，成功后点击 OK 保存。

三 连接本地与远程数据库

• 本地连接常用参数：Host 填 localhost，Port 填 3306（MySQL 默认），选择目标 Database，填入有权限的 User/Password 并测试连接。远程连接需确保：服务器防火墙放行对应端口（如 3306）；数据库配置允许远程（如编辑 /etc/mysql/mysql.conf.d/mysqld.cnf 将 bind-address 调整为 0.0.0.0 并重启 MySQL），同时在数据库中为远程用户授予来自客户端 IP 的访问权限。

四 常见问题与排查

• 驱动问题：首次连接若缺少驱动，使用内置 Download 安装；或按需手动添加对应驱动（如 MySQL Connector/J）。
• SSL 错误：若服务器启用 SSL，在 PhpStorm 的数据源设置中正确配置 SSL/TLS 相关选项（启用 SSL、指定证书等）。
• 客户端库缺失：连接 MySQL 时建议安装 mysql-client，可提升连接稳定性与兼容性。
• 服务与权限：确认数据库服务已启动（如 sudo systemctl status mysql），并为连接用户授予相应 host 与 权限。

五 常用操作与后续维护

• 在 Database 面板可浏览 表结构、查看/编辑数据、执行 SQL、以及进行 导入/导出 等；建议定期 更新 PhpStorm 与数据库驱动，以获得更好的兼容性与安全性。