或者在我的资料里直接下载也行
下载好了压缩包,接下来的安装配置其实非常直观。phpMyAdmin 是绿色免安装的,核心步骤就是**"解压 -> 改名配置文件 -> 放到网站根目录"**。
以下是保姆级的操作指南,假设你已经准备好了 PHP 和 MySQL 环境(如 XAMPP、WAMP 或宝塔面板等):
📦 第一步:解压与重命名
-
解压文件 :
将你下载的
.zip或.tar.gz压缩包解压。- 解压后通常会得到一个类似
phpMyAdmin-x.x.x-all-languages的长文件夹。 - 为了方便记忆和访问,建议将文件夹重命名为简单的
phpmyadmin。
- 解压后通常会得到一个类似
-
配置核心文件(最关键的一步) :
进入文件夹,找到名为
config.sample.inc.php的文件。- 复制 该文件,并将副本重命名为
config.inc.php。 - 注意:必须叫这个名字,否则系统无法读取配置,会报错。
- 如图所示,第一个和最后一个文件
- 复制 该文件,并将副本重命名为

⚙️ 第二步:修改配置(连接数据库)
用记事本或代码编辑器(如 VS Code、Notepad++)打开刚才新建的 config.inc.php 文件,进行以下修改:
-
设置加密密钥(解决报错) :
找到
$cfg['blowfish_secret'] = '';这一行。- 在单引号中间随意输入一串字符(建议长一点,包含字母数字),例如:
$cfg['blowfish_secret'] = 'my_secret_key_123456';。 - 作用:这是用于 Cookie 加密的密钥,如果不填,登录时可能会报错。
- 在单引号中间随意输入一串字符(建议长一点,包含字母数字),例如:
-
配置数据库连接(通常默认即可) :
找到
$cfg['Servers'][$i]['host']这一行。- 默认通常是
'localhost',如果你的数据库和网页在同一台电脑,不需要修改。 - 如果你的数据库在远程服务器,将其改为数据库的 IP 地址。
- 默认通常是
🚀 第三步:部署到服务器
根据你的运行环境,选择一种方式:
- Windows 本地环境 (如 XAMPP/WAMP) :
将重命名好的phpmyadmin文件夹,剪切到网站根目录中。- XAMPP 通常在:
C:\xampp\htdocs\ - WAMP 通常在:
C:\wamp64\www\
- XAMPP 通常在:
- Linux 服务器 (如 宝塔/CentOS/Ubuntu) :
将文件夹上传到网站根目录,例如/var/www/html/或/www/wwwroot/你的域名/。
🔐 第四步:权限设置 (仅限 Linux 服务器)
如果你是在 Linux 服务器上操作,为了安全起见,建议设置一下文件所有者和权限。在终端执行:
# 假设你的 Web 用户是 www-data (Ubuntu) 或 apache (CentOS)
sudo chown -R www-data:www-data /var/www/html/phpmyadmin
# 配置文件权限设为 644
sudo chmod 644 /var/www/html/phpmyadmin/config.inc.php
✅ 第五步:访问与登录
- 打开浏览器。
- 在地址栏输入:
- 本地:
http://localhost/phpmyadmin - 服务器 IP:
http://你的服务器IP/phpmyadmin
- 本地:
- 登录 :
- 用户名 :通常是
root - 密码:是你安装 MySQL 数据库时设置的密码。
- 用户名 :通常是
🛠️ 常见问题排查
- 提示"配置文件现在需要秘密短语" (The configuration file now needs a secret passphrase) :
- 原因:
config.inc.php里的$cfg['blowfish_secret']是空的。 - 解决:按照第二步第 1 点,在单引号里随便填一串字符即可。
- 原因:
- 提示"无法连接 MySQL" (Cannot connect: invalid settings) :
- 原因:数据库用户名或密码错误,或者数据库服务没启动。
- 解决:检查 MySQL 服务是否运行,并确认
config.inc.php中的用户名密码是否正确。
- 403 Forbidden (禁止访问) :
- 原因:通常是权限问题。
- 解决:检查文件夹权限,确保 Web 服务器用户(如
www-data)有读取权限。