Ubuntu上PHPStorm如何配置数据库连接
在Ubuntu上配置PhpStorm数据库连接需安装驱动及客户端库,通过Database窗口新建数据源,填写主机、端口、账号密码并测试连接。常见问题包括驱动缺失、客户端库未装、SSL设置及网络权限。连接后可对表进行增删改查并执行SQL。
在 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 列表勾选显示新库,马上就能用。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件,支持OCR公式识别和多平台编辑。和使用说明,避免使用,享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。
一款文字处理软件,一种订阅式的跨平台办公软件,基于云平台提供多种服务,通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合,Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具,通过键入缩写自动展开为自定义文段,提升工作效率。任务管理和过程控制会更完整,持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具,像本地磁盘一样使用网盘。清理链路的完整性会更好一些,做应用卸载、残留处理和空间整理时,通常能少走很多手动排查步骤。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件,支持OCR公式识别和多平台编辑。和使用说明,避免使用,享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。
一款文字处理软件,一种订阅式的跨平台办公软件,基于云平台提供多种服务,通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合,Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件,为私密数据添加多重保护。高频操作更强调就近处理,浏览、整理和跨目录移动文件时,来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具,通过键入缩写自动展开为自定义文段,提升工作效率。任务管理和过程控制会更完整,持续下载、批量同步或需要稳定传输流程的场景会更适合它。


























