CentOS上phpMyAdmin使用教程
在CentOS7上通过YUM安装phpMyAdmin需先配置EPEL仓库并安装相关包。安装后调整Apache配置文件允许远程访问,设置Blowfish密钥加密会话,重启Apache即可通过浏览器登录管理数据库。常见问题包括权限不足、密钥未生成及防火墙未开放端口。
不少朋友在 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(例如 http://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 了。
