phpstorm ubuntu如何连接数据库

在 Ubuntu 上用 PhpStorm 连接数据库

一 准备工作

• 启动数据库服务（以 MySQL 为例）：sudo systemctl start mysql；如需开机自启：sudo systemctl enable mysql。
• 安装数据库客户端库（驱动依赖），以便 PhpStorm 能连通数据库：sudo apt-get install mysql-client。
• 打开 PhpStorm 的数据库工具窗口：View → Tool Windows → Database。
  以上确保本机或远程数据库可被连接，并具备必要的客户端工具支持。

二 在 PhpStorm 中添加数据源

• 打开 Database 工具窗口，点击 + → Data Source，选择数据库类型（如 MySQL、PostgreSQL）。
• 在 General 选项卡填写连接信息：
  • Host：localhost 或服务器 IP/域名
  • Port：3306（MySQL 默认）
  • User / Password：数据库账户凭据
  • Database：要连接的数据库名
• 首次使用可点击 Download 获取驱动；随后点击 Test Connection 验证。
• 成功后点击 OK 保存。
  完成后即可在 Database 面板浏览表、执行 SQL、查看数据等。

三 常见连接场景与参数

• 本机数据库：Host 填 localhost，Port 3306；确保本机 MySQL 服务已启动。
• 远程数据库：Host 填服务器 公网/内网 IP，Port 3306；需确保云服务器安全组/防火墙放行 3306，且数据库用户允许来自你的来源 IP 访问。
• SSL 连接：若服务器启用 SSL/TLS，在 PhpStorm 的数据源设置中开启 SSL 并配置证书；遇到 SSL 错误 时核对服务器是否支持 SSL 及证书路径是否正确。
• 驱动问题：如提示缺少驱动，使用数据源窗口的 Download 下载对应驱动，再次测试连接。

四 常见问题排查

• Authentication plugin 错误（如 caching_sha2_password）：在数据库中为连接用户改用 mysql_native_password 插件，或创建新用户并授予权限：
  • ALTER USER ‘用户名’@‘来源IP’ IDENTIFIED WITH mysql_native_password BY ‘密码’;
  • FLUSH PRIVILEGES;
• 连接被拒绝/超时：核对 Host/IP、Port、用户名、密码；远程时检查 防火墙/安全组 是否放行 3306。
• SSL 握手失败：确认服务器启用 SSL，并在 PhpStorm 正确配置 SSL/证书 选项。
• 驱动不可用：在数据源界面点击 Download 补齐驱动后再测试。
  以上步骤覆盖了认证方式、网络连通性与驱动缺失等高频问题。