根本原因是Ubuntu 24.04默认PHP 8.3.6与phpMyAdmin稳定版对扩展（php-mysql、php-mbstring、php-xml）的包名及ABI兼容性存在隐性不匹配，需按实际PHP主版本（如php8.3或php8.4）显式安装带版本号的扩展包，并确保php-gd、json等依赖正确启用。
Ubuntu 24.04 上安装 phpMyAdmin 报错“依赖冲突”，根本原因不是你装错了，而是系统默认 PHP 版本（8.3.6）与 phpMyAdmin 当前稳定版（如 5.2.x / 5.3.x）对扩展的要求存在隐性不匹配——尤其是 php-mysql、php-mbstring 和 php-xml 这三个扩展在 8.3 和 8.4 下的包名、加载方式、甚至 ABI 兼容性都不同。
确认当前 PHP 版本和已启用扩展
先看清楚你到底在用哪个 PHP：运行 php -v 和 php -m | grep -E 'mysql|mysqli|mbstring|xml|gd'。Ubuntu 24.04 官方源只提供 php8.3，但如果你手动加了 ppa:ondrej/php 并装了 php8.4，而没同步更新 phpMyAdmin 的依赖包名，就会触发 apt 的版本锁死报错，例如：
phpmyadmin : Depends: php-mysql but it is not installable
Depends: php-mbstring but it is not installable
这是因为 php-mysql 在 8.4 环境下实际对应的是 php8.4-mysql，apt 不会自动做映射。
- 检查是否混用了多版本：运行
ls /usr/bin/php*，若同时存在php8.3和php8.4，但update-alternatives --config php指向了 8.4，而你却用apt install php-mysql（默认找 8.3 的包），必然失败 - 确认 phpMyAdmin 包来源：官方 Ubuntu 源里的
phpmyadmin是为php8.3编译的；若你用的是第三方源或手动下载的 .tar.gz，则必须严格匹配 PHP 主版本 - 不要跳过
php-gd：很多报错表面是 mysqli，实则是php-gd缺失导致 session 初始化失败，进而让依赖解析器误判
安装时必须显式指定 PHP 主版本前缀
Ubuntu 24.04 的 phpmyadmin 包不再“智能适配”PHP 版本。你必须根据当前 CLI 和 FPM 实际使用的版本，手动安装带版本号的扩展：
立即学习“PHP免费学习笔记（深入）”；
- 若用
php8.3：运行sudo apt install php8.3-mysql php8.3-mbstring php8.3-xml php8.3-gd php8.3-zip，再装phpmyadmin - 若用
php8.4：先确保已添加ppa:ondrej/php，然后装sudo apt install php8.4-mysql php8.4-mbstring php8.4-xml php8.4-gd php8.4-zip，最后再sudo apt install phpmyadmin - 安装
phpmyadmin时会弹出配置界面，选择apache2或lighttpd——注意：它**不会自动识别 nginx**，用 nginx 必须手动配置 fastcgi_pass
nginx 用户绕过 apache 依赖陷阱
Ubuntu 官方 phpmyadmin 包硬依赖 apache2 或 lighttpd，哪怕你只用 nginx，apt 也会试图拉 apache 相关包，引发冲突。解决办法是跳过该依赖：
- 下载 deb 包手动解压：
wget http://archive.ubuntu.com/ubuntu/pool/universe/p/phpmyadmin/phpmyadmin_5.2.1-2_all.deb（以实际版本为准） - 用
dpkg-deb -x phpmyadmin_*.deb /tmp/pma解压到临时目录 - 把
/tmp/pma/usr/share/phpmyadmin复制到/usr/share/phpmyadmin，并设置权限：sudo chown -R www-data:www-data /usr/share/phpmyadmin - 关键一步：编辑
/etc/php/8.4/apache2/php.ini（或对应版本的 cli/fpm ini）——其实 nginx 用的是 fpm 配置，所以应改/etc/php/8.4/fpm/php.ini，确保extension=mysqli和extension=mbstring已取消注释
常见错误：json_encode() 报错与 Twig 扩展缺失
即使 phpMyAdmin 启动了，访问时出现 Fatal error: Call to undefined function Twig\json_encode()，说明你正在用较新版本的 phpMyAdmin（如 5.3+），但它依赖的 twig/twig 组件在某些 PHP 8.4 构建中未正确加载 json 扩展。这不是 Twig 的 bug，而是 PHP 编译时漏掉了 --enable-json。
- 验证：运行
php -r "echo json_encode(['test']);"，若报错或无输出，证明json扩展根本没启用 - 检查
php --ini输出的配置文件路径，在对应php.ini中确认是否有extension=json（注意不是json.so，PHP 8.3+ 内置该扩展，但可能被 disable_functions 屏蔽） - 若用源码编译的 PHP，重编译时务必加上
--enable-json；若用 ondrej 源，该扩展默认启用，问题大概率出在disable_functions = json_encode这类错误配置上
最易被忽略的一点：phpMyAdmin 的 config.inc.php 中 $cfg['Servers'][$i]['auth_type'] = 'cookie' 要求 session 存储可用，而 session 启动失败（比如因 php-gd 缺失）会静默导致后续所有函数调用异常，包括 Twig 的 json_encode —— 所以排查顺序永远是：gd → mbstring → json → mysqli → session → cookie auth。
