在 Debian 上用 PhpStorm 连接数据库
一 准备工作
- 确认数据库已安装并运行：在 Debian 上常见为 MySQL/MariaDB 或 PostgreSQL。例如安装 MySQL 可执行：sudo apt update && sudo apt install mysql-server；安装后建议运行 sudo mysql_secure_installation 完成安全初始化。远程连接时，需确保数据库监听外部地址并开放防火墙端口（如 3306）。如使用远程数据库，还需在数据库中为相应用户授予从客户端 IP 访问的权限。
二 在 PhpStorm 中新建数据源
- 打开 Database 工具窗口：View > Tool Windows > Database（macOS 可用 PhpStorm > Preferences 打开设置入口）。
- 新建连接：点击 + > Data Source，选择数据库类型（如 MySQL、PostgreSQL）。
- 填写连接参数：
- Host：数据库地址（本机可用 localhost 或 127.0.0.1；远程填服务器 IP/域名）
- Port：如 3306（MySQL）、5432（PostgreSQL）
- User / Password：数据库账户凭据
- Database：要连接的库名（可留空以显示全部库）
- 驱动与测试：若提示缺少驱动，点击 Download 自动获取；随后点击 Test Connection 验证；成功后点击 OK 保存。
三 常见连接方式
- 本机直连：Host 填 localhost 或 127.0.0.1，确保数据库服务已启动（如 sudo systemctl status mysql）。
- 远程连接：
- 数据库侧：编辑 /etc/mysql/mysql.conf.d/mysqld.cnf，将 bind-address 改为 0.0.0.0（或注释掉该行）以监听所有地址；重启数据库；在数据库中执行授权（如 GRANT … TO ‘user’@‘客户端IP’ IDENTIFIED BY ‘pwd’; FLUSH PRIVILEGES;）。
- 网络侧：放行 3306 端口（如使用 ufw：sudo ufw allow 3306）。
- PhpStorm 侧：Host 填服务器 IP，Port 填 3306，填入有权限的账户凭据。
四 连接失败排查要点
- 服务与端口：确认数据库服务在运行（如 sudo systemctl status mysql），并用 sudo ss -tlnp | grep 3306 检查端口监听。
- 防火墙/云安全组：确保本机与云服务器安全组放行 3306（或所用端口）。
- 访问权限：数据库用户需允许从当前客户端 IP 连接（GRANT 语句与 FLUSH PRIVILEGES）。
- 驱动与参数：驱动未就绪时点击 Download；核对 Host、Port、User、Password、Database 是否准确；必要时启用 SSL/SSH 隧道（在数据源高级选项中配置）。
五 常用操作与效率提升
- 在 Database 工具窗口可浏览 表/视图/存储过程，双击对象打开编辑器；使用 SQL 选项卡执行查询与脚本，结果在下方面板展示。
- 可通过右键连接选择 Properties 调整连接设置，支持 SSH 隧道、SSL 等高级选项，便于安全地连接远程数据库。
