在 Ubuntu 上用 PhpStorm 连接数据库
一 准备工作
- 确认数据库已安装并运行(以 MySQL 为例):
- 安装:sudo apt update && sudo apt install mysql-server
- 安全初始化:sudo mysql_secure_installation
- 在 PhpStorm 打开数据库工具窗口:View → Tool Windows → Database,准备添加数据源。
二 在 PhpStorm 添加数据源
- 打开 Database 面板,点击 + → Data Source,选择数据库类型(如 MySQL、PostgreSQL)。
- 在 General 选项卡填写连接信息:
- Host:localhost 或服务器 IP
- Port:如 3306(MySQL)、5432(PostgreSQL)
- User / Password:数据库账户
- Database:要连接的库名(可留空以查看全部库)
- 首次使用若提示缺少驱动,点击 Download 自动安装;随后点击 Test Connection 验证,成功后 OK 保存。
三 本地与远程连接的关键设置
- 本地连接:保持 Host=localhost 即可;如使用 socket 连接,可在驱动属性中指定套接字路径(如 /var/run/mysqld/mysqld.sock)。
- 远程连接:
- 修改数据库配置以允许远程:编辑 /etc/mysql/mysql.conf.d/mysqld.cnf,将 bind-address 改为 0.0.0.0(或注释掉该行),重启 MySQL:sudo systemctl restart mysql。
- 确保云服务器或本机 防火墙 放行对应端口(如 3306)。
- 数据库账户需具备从客户端 IP 访问的权限(例如创建用户并授权远程访问)。
四 常见问题与排查
- 连接被拒绝或超时:核对 Host/Port、确保服务在运行(sudo systemctl status mysql)、检查 防火墙/安全组 是否放行端口。
- 驱动问题:在数据源属性中点击 Download 补齐驱动,或更新 PhpStorm 后同步驱动版本。
- SSL 错误:若服务器启用 SSL,在数据源的 SSL/TLS 选项中按服务器要求配置证书;本地开发可先关闭 SSL 验证进行对比排查。
- 权限不足:确认数据库用户允许从当前主机连接并对目标库有足够权限(如 GRANT 语句)。
五 常用操作与效率提升
- 在 Database 面板可浏览 表/视图/存储过程,双击表查看与编辑数据,支持行级 增删改查 与字段变更(图形化或生成 SQL)。
- 使用 SQL 控制台 执行脚本、保存常用查询、查看结果集;可在数据源上右键 Properties 调整连接属性,或使用 SSH 隧道 安全地连接远程数据库。