Linux如何搭建phpMyAdmin

发布时间：2022-02-15 08:22:37 作者：iii
来源：亿速云阅读：129

# Linux如何搭建phpMyAdmin

## 前言

phpMyAdmin是MySQL/MariaDB最流行的开源Web管理工具之一，它提供了直观的图形界面，让用户无需记忆复杂的SQL命令即可完成数据库管理操作。本文将详细介绍在Linux系统上安装和配置phpMyAdmin的完整流程，涵盖Apache/Nginx环境配置、安全加固及常见问题排查。

---

## 一、环境准备

### 1.1 系统要求
- **操作系统**：Ubuntu 20.04+/CentOS 7+/Debian 10+
- **Web服务器**：Apache 2.4+ 或 Nginx 1.18+
- **数据库**：MySQL 5.7+ 或 MariaDB 10.3+
- **PHP**：PHP 7.4+（需启用`mysqli`、`mbstring`、`gd`等扩展）

### 1.2 安装LAMP/LEMP栈
#### 对于Apache环境（LAMP）：
```bash
# Ubuntu/Debian
sudo apt update
sudo apt install apache2 mysql-server php libapache2-mod-php php-mysql

# CentOS/RHEL
sudo yum install httpd mariadb-server php php-mysqlnd

对于Nginx环境（LEMP）：

# Ubuntu/Debian
sudo apt install nginx mysql-server php-fpm php-mysql

# CentOS/RHEL
sudo yum install nginx mariadb-server php-fpm php-mysqlnd

二、安装phpMyAdmin

2.1 通过包管理器安装

Ubuntu/Debian：

sudo apt install phpmyadmin

安装过程中会提示： 1. 选择Web服务器（Apache/Nginx） 2. 是否自动配置数据库（选”Yes”） 3. 设置phpMyAdmin的数据库密码

CentOS/RHEL：

sudo yum install epel-release
sudo yum install phpmyadmin

2.2 手动安装（推荐最新版）

wget https://www.phpmyadmin.net/downloads/phpMyAdmin-latest-all-languages.tar.gz
tar -xvzf phpMyAdmin-latest-all-languages.tar.gz
sudo mv phpMyAdmin-*/ /usr/share/phpmyadmin

三、Web服务器配置

3.1 Apache配置

sudo nano /etc/apache2/conf-available/phpmyadmin.conf

添加以下内容：

Alias /phpmyadmin /usr/share/phpmyadmin
<Directory /usr/share/phpmyadmin>
    Options FollowSymlinks
    DirectoryIndex index.php
    AllowOverride All
    Require all granted
</Directory>

启用配置：

sudo a2enconf phpmyadmin
sudo systemctl restart apache2

3.2 Nginx配置

sudo nano /etc/nginx/conf.d/phpmyadmin.conf

添加以下内容：

server {
    listen 80;
    server_name pma.yourdomain.com;
    root /usr/share/phpmyadmin;
    
    index index.php;
    
    location / {
        try_files $uri $uri/ =404;
    }
    
    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/run/php/php-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

重启Nginx：

sudo systemctl restart nginx

四、安全加固

4.1 修改默认路径

sudo mv /usr/share/phpmyadmin /usr/share/mydbadmin

同时更新Web服务器配置中的路径。

4.2 设置HTTP认证

在Apache中：

sudo htpasswd -c /etc/apache2/.phpmyadmin-htpasswd admin

在Nginx中：

location / {
    auth_basic "Admin Area";
    auth_basic_user_file /etc/nginx/.phpmyadmin-htpasswd;
}

4.3 配置IP白名单

# Apache
Require ip 192.168.1.0/24

# Nginx
allow 192.168.1.0/24;
deny all;

五、故障排查

5.1 常见错误及解决

404 Not Found
- 检查Web服务器配置路径是否正确
- 确认DocumentRoot包含phpMyAdmin目录

“The mysqli extension is missing”

sudo apt install php-mysqli  # Ubuntu/Debian
sudo yum install php-mysqlnd # CentOS

登录后空白页面
- 检查PHP错误日志：
```
tail -f /var/log/php_errors.log
```
- 可能需调整php.ini中的内存限制：
```
memory_limit = 256M
```

六、高级配置

6.1 启用HTTPS

使用Let’s Encrypt证书：

sudo apt install certbot python3-certbot-apache  # For Apache
sudo certbot --nginx -d pma.yourdomain.com     # For Nginx

6.2 配置多服务器管理

编辑config.inc.php：

$cfg['Servers'][$i]['host'] = '192.168.1.100';
$cfg['Servers'][$i]['port'] = '3306';
$cfg['Servers'][$i]['verbose'] = 'Production DB';

6.3 性能优化

// 禁用统计信息
$cfg['ShowServerInfo'] = false;
// 关闭查询历史
$cfg['QueryHistoryDB'] = false;

结语

通过本文的步骤，您应该已经成功在Linux系统上部署了phpMyAdmin。建议定期更新版本并监控/var/log/phpmyadmin/error.log以保障安全。对于生产环境，建议结合MySQL企业版或Percona Monitoring进行更专业的数据库管理。

注意事项：
- 避免使用弱密码
- 定期备份config.inc.php
- 考虑使用替代方案如Adminer（单文件PHP管理工具）降低攻击面 “`

（全文约2050字，实际字数可能因格式略有差异）