结论：禁止用 Git 克隆安装开发版 phpMyAdmin 用于生产环境；必须通过 composer install 安装依赖，禁用 dev 分支自动更新，否则易因依赖冲突或版本未锁定导致白屏或 SQL 异常。
直接说结论：不要用 git 克隆安装开发版 phpmyadmin 用于生产环境，composer 依赖必须通过 composer install 安装，且需禁用 dev 分支的自动更新机制，否则极易因依赖冲突或未锁定版本导致界面白屏或 sql 执行异常。
克隆后执行 composer install 报错“package not found”
这是最常见现象：克隆的是 phpMyAdmin 主仓库（git clone https://github.com/phpmyadmin/phpmyadmin.git），但其 composer.json 中声明的依赖（如 phpmyadmin/motranslator）默认指向 dev-master 或带 @dev 的不稳定版本，而 Packagist 默认不收录开发分支 —— Composer 找不到包，就报 Package phpmyadmin/motranslator at version * has a PHP requirement incompatible with your PHP version 或更直白的 Could not find package ...。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先确认 PHP 版本满足要求（phpMyAdmin 5.2+ 要求 PHP ≥ 7.4；5.3+ 要求 ≥ 8.0）
- 运行
composer install --no-dev跳过开发依赖（如phpunit、phpstan），大幅降低冲突概率 - 若仍失败，临时启用 GitHub OAuth token（避免限流）：
composer config github-oauth.github.com YOUR_TOKEN - 绝不要手动改
composer.json里的"minimum-stability": "dev"—— 这会让所有依赖降级到不可控快照
vendor/ 目录权限错误导致登录页空白
Git 克隆 + Composer 安装后，vendor/ 下某些类文件（如 vendor/twig/twig/src/Environment.php）可能被写入不可执行的只读模式，尤其在 Windows WSL 或 macOS 上用不同用户切换操作后。浏览器打开 index.php 时无报错、无日志、纯白屏 —— 实际是 PHP 在 require 时静默失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查
vendor/autoload.php是否可被 web server 用户读取：ls -l vendor/autoload.php，确保不是-rw-r--r--且属主匹配（如 Apache 用www-data，Nginx 常用nginx或www-data） - 修复权限：
chmod -R u+rw vendor/（仅限开发机；生产环境应禁止 web 用户写vendor/） - 关键验证点：在
index.php开头加var_dump(class_exists('Twig\Environment'));，返回bool(false)就说明 autoloader 没加载成功
为什么不能用 composer create-project 替代 Git 克隆
因为 composer create-project phpmyadmin/phpmyadmin 安装的是稳定发行版（tagged release），比如 v5.2.1，它不包含开发分支的最新修复（如某个 MySQL 8.4 兼容补丁），也不含 git 历史 —— 你无法 git pull 更新，只能等下一个 tag 发布再重装。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 真要追踪开发进展，必须克隆 +
git checkout QA_5_3（当前稳定开发分支）或main（高风险） - 每次
git pull后，**必须重新运行composer install --no-dev --prefer-dist** —— 不是update，因为composer.lock已随代码提交锁定，install才能保证复现 CI 环境 - 注意
main分支的composer.json可能引用尚未发布的私有包（如phpmyadmin/shapefile的 dev 版），这时得加--repository-url=https://repo.packagist.com/phpmyadmin/
真正麻烦的从来不是命令敲不对，而是没意识到 phpMyAdmin 的 Composer 依赖链里混着三类东西：Packagist 正式包、GitHub 私有 repo、以及用 path 类型硬链接本地子模块（如 js 目录下的 jquery）。任何一个环节权限、网络或稳定性出问题，都会让整个页面卡在 require 阶段，还不报错。
