如何在Ubuntu用phpstorm连接数据库

在 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 隧道 是一种既方便又安全的连接方式，值得尝试。