Ubuntu 上 PhpStorm 配置数据库连接
一 准备与入口
- 打开数据库工具窗口:依次点击 View → Tool Windows → Database,或 File → Settings/Preferences → Languages & Frameworks → PHP → Database。
- 首次使用会提示下载数据库驱动,点击 Download 自动安装(如 MySQL 驱动)。
- 建议安装本机数据库客户端库以避免驱动或连接问题,例如 MySQL 可安装:
sudo apt-get install mysql-client。
- 需要远程连接时,确保数据库服务器允许你的 Ubuntu 主机访问(开放对应端口、云安全组策略等)。
二 新建数据源与基本参数
- 在 Database 工具窗口点击 + → Data Source,选择数据库类型(如 MySQL、PostgreSQL)。
- 在 General 选项卡填写连接信息:
- Host:数据库地址(本机可用 localhost 或 127.0.0.1,远程填服务器 IP)。
- Port:如 3306(MySQL 默认)。
- User / Password:数据库账户与密码。
- Database:要连接的数据库名(可留空,连接后再选择)。
- 点击 Test Connection 验证,成功后 OK 保存。
三 常见数据库示例
- MySQL
- 安装驱动:在数据源界面点击 Download 获取 MySQL 驱动。
- 典型参数:Host=localhost,Port=3306,User/Password 按实际填写。
- 若本机未安装客户端库,可执行:
sudo apt-get install mysql-client。
- 远程连接请确保服务器放行 3306 端口与账户权限。
- PostgreSQL
- 选择数据源 PostgreSQL,填写 Host、Port(默认 5432)、User、Password、Database。
- 首次使用同样可 Download 所需驱动。
四 连接失败排查
- 驱动问题:在数据源界面点击 Download 重新安装驱动。
- 客户端库缺失:安装对应 mysql-client 或 postgresql-client。
- SSL 错误:确认数据库是否启用 SSL,并在 PhpStorm 的 SSL 选项中按实际配置(启用/禁用、证书路径等)。
- 网络与权限:核对 Host/Port、云数据库安全组/防火墙、数据库用户 host 权限(如允许从你的 Ubuntu IP 连接)。
五 常用操作与效率提升
- 在 Database 窗口可直接对表进行 增删改查、编辑字段、执行 SQL;双击表查看与修改数据。
- 在 Schema & Tables 中勾选需要显示的 Schema/数据库,便于管理。
- 支持通过 SQL 创建数据库(如
CREATE DATABASE mydb;),执行后在 Schema 列表中勾选显示。