Ubuntu上PHPStorm如何配置数据库连接

在 Ubuntu 上折腾 PhpStorm 数据库连接，其实不算什么难事，但如果不熟悉其中的门道，失败几次也是很正常的。下面就把整个流程拆开讲一遍，从准备工作到常见坑，一次说清楚。

一、准备与入口

• 打开数据库工具窗口的路径有两个：View → Tool Windows → Database，或者从 File → Settings/Preferences → Languages & Frameworks → PHP → Database 进去。这个看个人习惯。
• 第一次点开 Database 窗口，PhpStorm 会提示下载对应的数据库驱动。没什么好犹豫的，点 Download 就行，它会自动把 MySQL 之类的驱动拉下来。
• 光有驱动还不够，本机最好也装上数据库客户端库。比如用 MySQL 的话，在终端跑一句 sudo apt-get install mysql-client，能避免很多底层驱动不兼容的问题。
• 如果目标是远程数据库，记得提前确认 Ubuntu 主机能被对方服务器允许访问。检查端口是否开放、云安全组策略是否配好——这些是网络层面的基本功。

二、新建数据源与基本参数

• 在 Database 窗口里点 + → Data Source，然后选数据库类型，MySQL 还是 PostgreSQL 一目了然。
• 进入 General 选项卡后，需要填的内容就这几项：
  • Host：本机填 localhost 或 127.0.0.1，远程填服务器的 IP。
  • Port：MySQL 默认 3306，PostgreSQL 默认 5432。
  • User / Password：数据库的账户和密码。
  • Database：可以留空，等连上之后再选择具体库。
• 填完之后点 Test Connection，绿了就算成功，直接 OK 保存。如果红了，那就往下看排查部分。

三、常见数据库示例

• MySQL
  • 驱动缺失的话，在数据源界面点 Download 就能装好。
  • 典型参数：Host=localhost，Port=3306，User/Password 看你的真实配置。
  • 本机没装客户端库？跑 sudo apt-get install mysql-client 完事。
  • 远程连接必须确保服务器放行 3306 端口，并且数据库用户的 host 权限包含你的 Ubuntu IP。
• PostgreSQL
  • 数据源选 PostgreSQL，同样填 Host、Port（默认 5432）、User、Password、Database。
  • 首次使用也是点 Download 安装驱动，流程和 MySQL 几乎一样。

四、连接失败排查

• 驱动问题：回到数据源界面重新点 Download 安装驱动，有时候网络波动会导致安装不完整。
• 客户端库缺失：装对应的 mysql-client 或 postgresql-client，跑命令就对了。
• SSL 错误：先确认数据库是否开启了 SSL。如果开了，PhpStorm 的 SSL 选项里要按实际配置证书路径或模式；如果没开，那就把 SSL 禁用掉。
• 网络与权限：Host/Port 核对清楚了吗？云数据库的安全组放行来源 IP 了吗？数据库用户的 host 字段允许从这台 Ubuntu 连接吗？这三个点最容易被忽略。

五、常用操作与效率提升

• Database 窗口里，对着表可以直接增删改查、编辑字段、执行 SQL。双击某张表就能查看和修改数据，比命令行直观多了。
• 在 Schema & Tables 里勾选需要显示的 Schema 或数据库，能避免一堆无关表干扰视线，管理起来更清爽。
• 如果需要新建数据库，直接在控制台执行 CREATE DATABASE mydb;，然后回到 Schema 列表勾选显示新库，马上就能用。