在 Ubuntu 上用 PhpStorm 连接数据库
一 准备工作
在动手连接之前，有几项基础工作需要确保到位。首先，你得确认数据库服务已经安装并且正在运行。这里以 MySQL 为例：
- 安装：通过终端执行
sudo apt update && sudo apt install mysql-server即可完成安装。 - 安全初始化：安装后，强烈建议运行
sudo mysql_secure_installation来设置 root 密码并移除一些不安全的默认配置。
搞定数据库后，打开 PhpStorm，通过菜单栏的 View → Tool Windows → Database 打开数据库工具窗口，准备添加你的数据源。
二 在 PhpStorm 添加数据源
接下来就是核心的连接配置了。在 Database 面板，点击左上角的 + 号，选择 Data Source，然后从列表里找到你的数据库类型，比如 MySQL 或 PostgreSQL。
在弹出的配置窗口中，切换到 General 选项卡，开始填写连接信息：
- Host：本地开发就填
localhost，远程则填服务器 IP 地址。 - Port：默认端口即可，例如 MySQL 是 3306，PostgreSQL 是 5432。
- User / Password：填写有访问权限的数据库账户和密码。
- Database：这里可以填写具体要连接的库名，如果留空，则会显示服务器上所有的数据库。
如果是首次连接这类数据库，PhpStorm 可能会提示缺少驱动。别担心，直接点击 Download 按钮，它会自动下载并安装。最后，点击 Test Connection 按钮，看到成功的提示后，点击 OK 保存配置，连接就建立好了。
三 本地与远程连接的关键设置
连接场景不同，配置的侧重点也略有差异。
本地连接相对简单，保持 Host 为 localhost 通常就能成功。如果习惯使用 socket 连接，可以在驱动属性里指定套接字路径，例如 /var/run/mysqld/mysqld.sock。
远程连接则多几个步骤：
- 首先，需要修改数据库服务器的配置以允许远程访问。以 MySQL 为例，编辑配置文件
/etc/mysql/mysql.conf.d/mysqld.cnf，找到bind-address这一行，将其值改为0.0.0.0或者直接注释掉，然后重启服务：sudo systemctl restart mysql。 - 其次，确保服务器防火墙或云服务商的安全组规则已经放行了数据库端口（比如 3306）。
- 最后，数据库用户必须被授予从你的客户端 IP 地址进行访问的权限，这通常需要通过专门的授权语句来完成。
四 常见问题与排查
连接过程偶尔会遇到一些小麻烦，这里有几个典型的排查方向：
- 连接被拒绝或超时：先核对 Host 和 Port 是否填错，然后确认数据库服务是否真的在运行（
sudo systemctl status mysql），最后检查防火墙或云平台安全组设置。 - 驱动问题：如果遇到驱动类错误，可以尝试在数据源属性中再次点击 Download 来补全驱动，或者更新 PhpStorm 到最新版。
- SSL 错误：如果数据库服务器启用了 SSL 连接，需要在数据源配置的 SSL/TLS 选项中配置相应证书。对于本地开发调试，可以暂时关闭 SSL 验证来对比排查。
- 权限不足：确认你使用的数据库用户不仅拥有登录权限，还对目标数据库具备足够的操作权限（例如 SELECT、INSERT 等），这可能需要通过 GRANT 语句重新授权。
五 常用操作与效率提升
成功连接后，PhpStorm 的数据库工具能极大提升你的工作效率。在 Database 面板里，你可以直观地浏览所有表、视图和存储过程。
- 双击任何一张表，可以直接查看和编辑其中的数据，支持行级的增删改查，字段变更也能通过图形界面或自动生成的 SQL 来完成。
- 善用 SQL 控制台，可以执行复杂的脚本、保存常用查询语句，并清晰地查看结果集。
- 你还可以在数据源上右键选择 Properties 来调整高级连接属性。对于远程连接，使用 SSH 隧道 是一种既方便又安全的连接方式，值得尝试。
