Ubuntu下为PHP7.4与PHP8.1配置多PHPMyAdmin及配置验证

一、PHP8.1安装PHPMyAdmin及多PHP版本配置说明 #

是否需要多个PHPMyAdmin实例？ #

不需要单独为每个PHP版本安装独立的PHPMyAdmin。PHPMyAdmin本身是PHP应用，只要配置让它对应使用指定PHP版本运行即可，一个实例可通过Apache配置适配不同PHP版本，无需重复安装。

为PHP8.1安装并配置PHPMyAdmin步骤 #

1. 先安装PHP8.1所需的核心扩展（PHPMyAdmin依赖这些扩展运行）：

   sudo apt install php8.1-mysql php8.1-mbstring php8.1-zip php8.1-gd php8.1-curl php8.1-json php8.1-xml
   

2. 安装PHPMyAdmin（若未安装过）：

   sudo apt install phpmyadmin
   

   安装过程中选择Apache作为Web服务器，按提示设置数据库管理员密码即可。
3. 配置Apache让PHPMyAdmin使用PHP8.1：
   • 若要全局切换为PHP8.1，先禁用PHP7.4模块，启用PHP8.1模块：

     sudo a2dismod php7.4
     sudo a2enmod php8.1
     sudo systemctl restart apache2
     

   • 若仅让特定虚拟主机使用PHP8.1（全局保留PHP7.4），需先安装PHP8.1-FPM：

     sudo apt install php8.1-fpm
     

     再在对应虚拟主机配置中添加PHP8.1的处理规则（下文配置示例会包含）。

二、Apache虚拟主机配置验证 #

你提供的/etc/apache2/sites-available/newinstance.conf存在两处关键问题：

1. DocumentRoot路径错误：默认PHPMyAdmin的安装路径是/usr/share/phpmyadmin，/usr/share/phpmyadmin/newinstance除非是你手动复制的独立实例，否则该路径不存在，会导致404错误。
2. 缺少PHP版本指定：若全局Apache使用PHP7.4，该虚拟主机未明确指定PHP8.1，会默认用PHP7.4运行PHPMyAdmin，达不到使用PHP8.1的目的。

修正后的配置示例 #

<VirtualHost *:80>
    ServerName newinstance.example.com
    # 若为默认PHPMyAdmin实例，使用此路径；若为自定义实例，替换为你实际的目录
    DocumentRoot /usr/share/phpmyadmin

    # 指定该虚拟主机使用PHP8.1-FPM处理PHP文件
    <FilesMatch \.php$>
        SetHandler "proxy:unix:/run/php/php8.1-fpm.sock|fcgi://localhost/"
    </FilesMatch>

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

    # 可选：添加日志配置，方便排查问题
    ErrorLog ${APACHE_LOG_DIR}/newinstance-error.log
    CustomLog ${APACHE_LOG_DIR}/newinstance-access.log combined
</VirtualHost>

配置生效步骤 #

完成修改后，启用虚拟主机并重启Apache：

sudo a2ensite newinstance.conf
sudo systemctl reload apache2

内容的提问来源于stack exchange，提问作者Rushikesh Solanki