Debian下PhpStorm连接数据库完整步骤
1. 准备数据库环境（Debian系统）
在配置PhpStorm数据库连接前，需确保Debian系统上已安装并运行数据库服务（以MySQL为例，MariaDB同理）。
- 更新系统包列表：运行
sudo apt-get update，确保系统包信息最新。
- 安装MySQL服务器：执行
sudo apt-get install mysql-server，安装过程中会提示设置root用户密码（务必牢记）。
- 强化数据库安全：运行
sudo mysql_secure_installation，按提示完成以下配置：
- 设置密码强度规则；
- 删除匿名用户；
- 禁止root用户远程访问（本地开发无需开启）；
- 移除测试数据库。
- 登录MySQL验证：执行
mysql -u root -p，输入root密码即可进入MySQL命令行，确认数据库服务正常运行。
2. 打开PhpStorm数据库配置界面
启动PhpStorm后，通过以下路径进入数据库设置：
- 点击顶部菜单栏File > Settings（Windows/Linux快捷键
Ctrl+Alt+S，macOS为PhpStorm > Preferences）；
- 在设置窗口左侧，展开Languages & Frameworks分类，选择PHP > Database（部分版本可能直接显示“Database”选项）。
3. 添加新的数据库连接
- 在“Database”设置页面，点击右侧**+号，选择Data Source**；
- 从弹出的数据库类型列表中，选择要连接的数据库（如MySQL、MariaDB，若需连接PostgreSQL则选择对应类型）。
4. 填写数据库连接参数（以MySQL为例）
根据实际环境输入以下关键信息：
- Host：数据库服务器地址（本地开发填
localhost或127.0.0.1；远程数据库填服务器IP或域名）；
- Port：数据库端口（MySQL默认
3306，若修改过端口需填写新端口）；
- User：数据库用户名（如
root或其他有访问权限的用户）；
- Password：对应用户的密码（若未设置密码，可留空）；
- Database：要连接的具体数据库名称（需提前在MySQL中创建，命令：
CREATE DATABASE 数据库名;）。
5. 测试与保存连接
- 点击Test Connection按钮，若弹出Connection successful提示，则表示配置正确；
- 测试通过后，点击OK保存设置，此时数据库连接会显示在“Database”工具窗口中（可通过
View > Tool Windows > Database打开）。
6. （可选）配置远程数据库连接
若需连接远程数据库（非本地），需额外完成以下步骤：
- 开放防火墙端口：允许数据库端口（如3306）通过，执行
sudo ufw allow 3306；
- 修改MySQL配置：编辑
/etc/mysql/mysql.conf.d/mysqld.cnf文件，将bind-address = 127.0.0.1改为bind-address = 0.0.0.0（允许所有IP访问）；
- 重启MySQL服务：执行
sudo systemctl restart mysql；
- 授权远程用户：在MySQL中执行
GRANT ALL PRIVILEGES ON 数据库名.* TO '用户名'@'%' IDENTIFIED BY '密码';（%表示允许任意IP访问），然后执行FLUSH PRIVILEGES使授权生效。
7. （可选）使用SSH隧道连接（解决无法直接访问问题）
若远程数据库位于内网或无法直接访问，可通过SSH隧道间接连接：
- 在PhpStorm的数据库配置页面，勾选SSH/SSL选项；
- 输入SSH服务器信息（如主机名、端口、用户名），并选择认证方式（密码或密钥文件）；
- 保存设置后，PhpStorm会通过SSH隧道转发数据库请求，无需直接暴露数据库端口。
注意事项
- 确保PHP的mysqli或PDO_MySQL扩展已启用（检查
php.ini文件，取消对应扩展前的注释，如extension=mysqli）；
- 远程连接时，需确保数据库用户拥有对应数据库的访问权限（可通过
GRANT命令调整）；
- 若连接失败，可通过PhpStorm的“Event Log”或数据库服务的日志文件排查问题（如密码错误、端口未开放、权限不足）。