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”或数据库服务的日志文件排查问题(如密码错误、端口未开放、权限不足)。