在 Debian 上配置 PhpStorm 数据库连接
一 准备与安装
- 安装数据库（以 MySQL 为例）：sudo apt update && sudo apt install mysql-server；完成后执行 sudo mysql_secure_installation 做基础安全设置。
- 安装 PHP 与数据库扩展：sudo apt install php php-mysql（如使用 PostgreSQL，则安装 php-pgsql）。
- 重启 Web 服务或 PHP-FPM：sudo systemctl restart apache2 或 sudo systemctl restart php8.x-fpm。
- 启动 PhpStorm，准备在 IDE 内添加数据源。
二 在 PhpStorm 中添加数据源
- 打开设置：File → Settings → Languages & Frameworks → PHP → Database（macOS 为 Preferences）。
- 新增数据源：点击 + → Data Source → MySQL（或 PostgreSQL、SQLite 等）。
- 填写连接信息：
- Host：localhost（本机）或服务器 IP/域名
- Port：3306（MySQL 默认）
- Database：要连接的库名（可留空，稍后在 Schema 里勾选）
- User / Password：数据库账户凭据
- 驱动与测试：若提示缺少驱动，点击 Download 自动安装；点击 Test Connection 验证；成功后 OK 保存。
三 常见连接方式
- 本机数据库：Host 填 localhost，Port 3306，使用具备权限的数据库用户。
- 远程数据库：Host 填服务器 公网/内网 IP，确保云厂商安全组或本机防火墙放行 3306/TCP；MySQL 8 建议使用 caching_sha2_password 或创建可远程登录的专用账户。
- 容器与 WSL：若在 Docker/WSL 中运行数据库，Host 使用容器/子系统 网关或主机 IP，不要写 127.0.0.1。
- 通过 phpMyAdmin：phpMyAdmin 只是管理工具，PhpStorm 仍应直接连数据库主机（IP/域名 + 端口 + 账户），而不是连 phpMyAdmin 的 80/443。
四 排错要点
- 连接失败：核对 主机、端口、用户名、密码；远程场景优先用服务器的 私有 IP 测试；必要时抓包或查看数据库错误日志。
- 驱动问题：首次连接若提示缺少驱动，点击 Download 安装对应 JDBC/Connector。
- 权限问题：确保数据库用户允许从 PhpStorm 所在主机连接（MySQL 的 user@host 权限与 bind-address 配置）。
- Web 框架路由与数据库：若使用框架（如 Laravel），Database 工具仅用于连接与操作数据库，与框架路由无直接关系。
五 常用后续操作
- 在 Database 工具窗口可浏览 表/视图/结构，直接执行 SQL，并对表数据进行 增删改查；也可在 Schema & Tables 中勾选需要显示的库表。