在 Debian 上配置 PhpStorm 数据库连接
一 前置准备
- 安装数据库服务器（以 MySQL 为例）：sudo apt update && sudo apt install mysql-server；安装完成后执行 sudo mysql_secure_installation 完成安全初始化。
- 安装 PHP 与数据库扩展（用于 CLI/Web 环境）：sudo apt install php php-mysql。
- 启动并验证服务：sudo systemctl start mysql；sudo systemctl enable mysql；mysql -V 检查版本。
- 如需远程连接，请先在 MySQL 中创建允许远程的账号，并规划访问来源（IP/网段）。
二 在 PhpStorm 中新建数据源
- 打开设置：File → Settings → Languages & Frameworks → PHP → Database（macOS 为 Preferences）。
- 点击 + → Data Source → 选择 MySQL（或 PostgreSQL 等）。
- 填写连接参数：
- Host：数据库主机，本地可为 localhost，远程填服务器 IP/域名；
- Port：3306（MySQL 默认）；
- Database：要连接的数据库名（可留空后选择）；
- User / Password：数据库账户凭据；
- URL 一般会自动生成。
- 驱动：如提示缺少驱动，点击 Download 自动获取。
- 测试与保存：点击 Test Connection，成功后 Apply/OK。
三 连接参数与常见场景
- 本地开发：Host 填 localhost，使用系统包安装的 unix socket 通常可直连；如需强制走 TCP，可用 127.0.0.1。
- 远程服务器：Host 填服务器 公网/内网 IP，确保云厂商安全组与服务器防火墙放行 3306/TCP；MySQL 账户需允许对应来源主机。
- phpMyAdmin 不是数据库服务器：PhpStorm 直接连 MySQL 实例（主机/端口/账户），无需经过 phpMyAdmin；若仅能访问 phpMyAdmin，请在 phpMyAdmin 中确认数据库主机、端口与账户权限，再回到 PhpStorm 使用相同参数直连。
四 常见故障排查
- Authentication plugin 错误（如 caching_sha2_password）：在 MySQL 为该用户执行 ALTER USER ‘user’@‘host’ IDENTIFIED WITH mysql_native_password BY ‘password’; 然后 FLUSH PRIVILEGES; 再测试连接。
- 无法连接到 127.0.0.1：检查 mysql 服务是否运行（sudo systemctl status mysql），以及端口监听（ss -lntp | grep 3306）。
- 远程连不通：核对云安全组/服务器防火墙放行 3306/TCP，并确认 MySQL 账户的主机限制为你的客户端 IP 或 %。
- 驱动问题：在数据源界面点击 Download 补齐驱动，或手动指定 JDBC/Connector 版本。
- 编码问题：在数据源参数中设置 characterEncoding=utf8mb4，避免中文乱码。
五 常用操作与效率提升
- 在 Database 工具窗口可直接浏览表、视图、执行 SQL、查看执行计划与数据变更历史。
- 支持生成 PHP 数据访问代码、导出结果集、结构同步与对比等，提高日常开发与调试效率。
