许多用户在 CentOS 上搭建好 LAMP 环境后,往往希望安装 phpMyAdmin 来管理数据库,毕竟图形化界面比命令行操作更为直观。本文将详细介绍在 CentOS 7 环境下通过 YUM 安装配置 phpMyAdmin 的完整流程,按照步骤操作基本不会遇到问题。

一、环境准备
开始安装前,请先确认以下环境条件是否满足:
- 系统版本:支持 CentOS 7 及以上版本,本文以 CentOS 7 为例进行说明;
- 必备软件:需要预先安装 Apache(Web 服务器)、MySQL/MariaDB(数据库)以及 PHP(编程语言),且版本必须兼容——phpMyAdmin 5.x 要求 PHP 7.1.3 或更高版本;
- 仓库配置:建议先安装 EPEL 仓库(Extra Packages for Enterprise Linux),以便顺利获取 phpMyAdmin 等第三方软件包。
二、安装 phpMyAdmin
1. 安装 EPEL 仓库(若尚未安装)
sudo yum install epel-release -y
2. 安装 phpMyAdmin
直接使用 YUM 包管理器进行安装,系统会自动处理依赖关系,省时省力:
sudo yum install phpmyadmin -y
安装过程中系统会提示确认,输入 y 并回车即可继续。
三、配置 phpMyAdmin
1. 调整访问权限(允许远程访问)
默认情况下,phpMyAdmin 仅允许本地 (127.0.0.1) 访问。若需要从其他机器登录,需修改 Apache 的配置文件:
sudo vi /etc/httpd/conf.d/phpMyAdmin.conf
找到以下内容(针对 Apache 2.4):
Require ip 127.0.0.1Require ip ::1
将其替换为:
Require all granted
保存并退出(按 Esc 键,输入 :wq 回车)。
2. 设置 Blowfish 密钥(提升安全性)
如果采用 cookie 认证方式(默认设置),则需要生成一个 Blowfish 密钥来加密会话信息。编辑 phpMyAdmin 配置文件:
sudo vi /etc/phpMyAdmin/config.inc.php
找到 $cfg['blowfish_secret'] 所在行,将其修改为包含随机字符串(长度至少 32 位):
$cfg['blowfish_secret'] = 'your_random_secret_key_here'; // 例如:abcd1234efgh5678ijkl9012mnop3456qrst7890
保存并退出。
3. (可选)设置默认语言为中文
若希望直接显示中文界面,可编辑 /etc/phpMyAdmin/config.inc.php,添加以下一行配置:
$cfg['Lang'] = 'zh_CN';
保存并退出。
四、启动服务并测试访问
1. 重启 Apache 服务
使配置生效:
sudo systemctl restart httpd
同时设置 Apache 开机自启:
sudo systemctl enable httpd
2. 测试访问
在浏览器中输入服务器的 IP 地址或域名,并在其后添加 /phpmyadmin(例如 https://192.168.1.100/phpmyadmin),即可看到登录页面。使用 MySQL 的 root 账号和密码登录,或使用自行创建的其他用户,即可通过 Web 界面管理数据库。
五、常见问题排查
1. 403 Forbidden 错误
此错误通常是因为 Apache 未允许访问 phpMyAdmin 目录。请返回“调整访问权限”步骤,确认已将 Require all granted 正确写入配置文件,然后重启 Apache。
2. Blowfish 密钥缺失错误
原因可能是未设置 $cfg['blowfish_secret'] 或密钥长度不足。编辑 /etc/phpMyAdmin/config.inc.php 补上符合要求的密钥,重启 Apache 即可解决。
3. 无法远程访问
可能由防火墙未开放 80 端口(HTTP)或 SELinux 限制导致。处理方法如下:
- 开放防火墙端口:执行
sudo firewall-cmd --permanent --add-service=http,然后sudo firewall-cmd --reload; - 临时禁用 SELinux:执行
sudo setenforce 0(如需永久禁用,可编辑/etc/selinux/config,将SELINUX=disabled写入并保存)。
按照以上步骤操作,在 CentOS 上完成 phpMyAdmin 的安装通常不会遇到困难,之后即可通过网页高效管理 MySQL/MariaDB 数据库。
