CentOS上phpMyAdmin使用教程

作者:技术拾光时间:2026-07-07 08:19:52浏览:299

在CentOS7上通过YUM安装phpMyAdmin需先配置EPEL仓库并安装相关包。安装后调整Apache配置文件允许远程访问,设置Blowfish密钥加密会话,重启Apache即可通过浏览器登录管理数据库。常见问题包括权限不足、密钥未生成及防火墙未开放端口。

不少朋友在 CentOS 上搭建好 LAMP 环境后,都会考虑安装 phpMyAdmin 来管理数据库,毕竟图形界面比命令行更直观。下面详细介绍在 CentOS 7 上通过 YUM 安装配置 phpMyAdmin 的完整流程,按步骤操作基本不会遇到问题。

CentOS上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 了。