因为 apt 安装的 phpMyAdmin 版本老旧（如 Ubuntu 22.04/24.04 中为 5.1.x），不支持 PHP 8.3+ 的 strict 类型检查，缺少新 UI 和安全补丁；源码部署可获取最新稳定版（如 5.2.2+），并自由控制配置路径、权限及运行时行为。
为什么不用 apt install phpmyadmin 而要源码部署
因为 apt 安装的 phpMyAdmin 版本老旧（Ubuntu 22.04/24.04 仓库中仍为 5.1.x），不支持 PHP 8.3+ 的 strict 类型检查，也缺少新 UI 和安全补丁；源码部署能拿到最新稳定版（如 5.2.2+），且可自由控制配置路径、权限和运行时行为。
下载并解压 phpMyAdmin 源码到 Web 可访问目录
别把源码丢进 /var/www/html 根目录下硬塞——容易混入其他项目、权限难管。推荐统一放在 /usr/local/share/phpmyadmin，再用符号链接暴露给 Apache：
- 先创建目标目录：
sudo mkdir -p /usr/local/share/phpmyadmin - 用
wget下载最新 tar.gz（查官网 https://www.phpmyadmin.net/downloads/ 获取链接）：wget https://files.phpmyadmin.net/phpMyAdmin/5.2.2/phpMyAdmin-5.2.2-all-languages.tar.gz - 解压并清理：
tar -zxf phpMyAdmin-5.2.2-all-languages.tar.gz -C /tmp && sudo cp -r /tmp/phpMyAdmin-5.2.2-all-languages/* /usr/local/share/phpmyadmin/ && rm -rf /tmp/phpMyAdmin-5.2.2-all-languages phpMyAdmin-5.2.2-all-languages.tar.gz - 设好所有权：
sudo chown -R www-data:www-data /usr/local/share/phpmyadmin - 在 Apache 文档根下建软链：
sudo ln -sf /usr/local/share/phpmyadmin /var/www/html/phpmyadmin
用 Composer 安装前端依赖并生成自动加载器
phpMyAdmin 自 5.0 起已弃用 vendor 预打包方式，必须用 Composer 安装 JS/CSS 构建依赖（yarn 已移除，全靠 composer install）：
- 确保系统有
composer（不是 Ubuntu 仓库版！见知识库：必须用官方 PHAR 安装） - 进入源码目录：
cd /usr/local/share/phpmyadmin - 执行：
sudo -u www-data composer install --no-dev --optimize-autoloader - 关键点：
--no-dev防止 dev-only 包污染生产环境；--optimize-autoloader加速类加载；sudo -u www-data避免生成的vendor/权限错乱 - 验证：
ls -l vendor/autoload.php应存在且可读
配置 blowerfish_secret 并启用存储功能（可选但推荐）
没配 $cfg['blowfish_secret'] 会导致 cookie 登录失败；不启用存储数据库（phpmyadmin 系统库），书签、历史、用户偏好等功能就不可用：
立即学习“PHP免费学习笔记（深入）”；
- 复制样本配置：
sudo cp /usr/local/share/phpmyadmin/config.sample.inc.php /usr/local/share/phpmyadmin/config.inc.php - 编辑
config.inc.php，找到$cfg['blowfish_secret']行，填入 32 字节随机字符串：$cfg['blowfish_secret'] = 'Zv9xKq7LmN2tYfRjWpEhBcGdUaXsIoVn';（用openssl rand -base64 32 | tr -d '\n'; echo生成） - 若要启用存储功能，先用 MySQL 创建库：
CREATE DATABASE phpmyadmin; GRANT SELECT,INSERT,UPDATE,DELETE ON phpmyadmin.* TO 'pma'@'localhost' IDENTIFIED BY 'strongpass'; - 再在
config.inc.php中取消注释并修正以下段落：$cfg['Servers'][$i]['controluser'] = 'pma'; $cfg['Servers'][$i]['controlpass'] = 'strongpass'; $cfg['Servers'][$i]['pmadb'] = 'phpmyadmin'; - 最后导入表结构：
sudo -u www-data php /usr/local/share/phpmyadmin/sql/create_tables.sql | mysql -u pma -pstrongpass phpmyadmin
最常被跳过的其实是 composer install 的用户上下文和 blowfish_secret 的长度校验——前者导致 500 错误，后者让登录页反复刷新却无提示。别图省事用 root 直接跑 composer，也别抄网上“随便写个字符串”，PHP 会静默拒绝非 32 字节值。
