在 Debian 上用 PhpStorm 连接数据库
一 准备与安装
- 安装数据库（以 MySQL 为例）：sudo apt update && sudo apt install mysql-server；如使用 PostgreSQL：sudo apt install postgresql。完成后可确认服务状态：sudo systemctl status mysql 或 sudo systemctl status postgresql。
- 安装 PHP 与数据库扩展（以 PHP 8.2 为例）：sudo apt install php php-mysql（PostgreSQL 可用：sudo apt install php-pgsql）。
- 启动或重启 Web 服务：sudo systemctl restart apache2 或 sudo systemctl restart nginx。
- 打开 PhpStorm，进入 Preferences/Settings → Languages & Frameworks → PHP → Database，在右侧点击 + → Data Source，选择 MySQL/PostgreSQL 等类型。
二 在 PhpStorm 中新建数据源
- 打开右侧 Database 工具窗口（View → Tool Windows → Database），点击 + → Data Source → MySQL/PostgreSQL。
- 填写连接信息：
- Host：数据库主机（本机可用 localhost 或 127.0.0.1；远程填服务器 IP）。
- Port：默认 3306（MySQL）、5432（PostgreSQL）。
- User / Password：数据库账户与密码。
- Database：要连接的库名（可留空，连接后再选）。
- 驱动与 SSL：如提示缺少驱动，点击 Download 自动获取；需要加密时配置 SSL/TLS。
- 测试与保存：点击 Test Connection，成功后 OK/Apply 保存。
三 常见连接场景与参数
- 本机数据库：Host 填 localhost 或 127.0.0.1；确保本机数据库监听 127.0.0.1:3306/5432。
- 远程数据库：Host 填服务器公网/内网 IP；确保云厂商安全组/服务器防火墙放行对应 端口，且数据库用户允许来自该 来源 IP 的连接。
- 容器/虚拟机：优先使用 主机 IP（如 192.168.x.x 或 10.x.x.x），不要使用 localhost；确认容器端口已映射到宿主机。
- 连接失败速查：核对 Host/Port/User/Password；检查 防火墙/安全组；确认数据库用户 host 权限；必要时开启 SSL。
四 连接后的常用操作
- 浏览与编辑：在 Database 窗口展开 Schemas/Tables，查看字段、索引、外键；可在结果面板直接 编辑数据 并同步到数据库。
- 执行 SQL：右键数据库或表 → Jump to Query Console 打开控制台；支持 SQL 模板、语法高亮、结果集导出。
- 可视化与迁移：可生成 ER 图（Diagrams）、导出 DDL、对比与生成迁移脚本，便于团队协作。
五 排错要点
- 驱动问题：若提示缺少驱动，点击 Download；或手动在驱动选项中更新。
- 服务未启动：确认 mysql/postgresql 服务已运行（sudo systemctl status …）。
- 权限与来源限制：数据库用户需允许从 PhpStorm 所在机器 IP 连接（例如创建用户时指定 host 或使用 % 通配并限制来源网段）。
- 端口与防火墙：确认 3306/5432 未被占用且已放行；云服务器需配置 安全组 规则。
- 编码与区域：如出现中文乱码，确保数据库与客户端使用 UTF-8，并在连接参数中设置合适的字符集。
