laravel-admin安装失败主因是php版本或扩展不满足依赖要求：需确认cli端php -v真实版本≥7.3，且必装mbstring、openssl等扩展；调试可临时用--ignore-platform-req=php跳过php校验，禁用--ignore-platform-reqs以防运行时崩溃。
laravel-admin 安装失败，大概率不是包本身问题，而是 PHP 版本不匹配或扩展缺失——它明确要求 PHP >= 7.3，且 Laravel 依赖链会进一步抬高门槛。
确认当前 CLI PHP 版本是否真实达标
网页端 phpinfo() 或 IDE 显示的版本 ≠ Composer 实际调用的版本。运行 php -v 看输出，重点核对小版本号（如 7.4.33 是 OK 的，7.2.34 就不行）。常见陷阱：
- 系统默认是 PHP 7.4，但你用
php8.2命令能跑，而 Composer 默认走php——此时php -v必须输出 7.3+ - Mac 上用 Homebrew 装了多个 PHP，
which php指向旧版，但php -v可能被 alias 干扰，建议直接运行/usr/bin/php -v或$(which php) -v - Docker 或 Valet 环境下，CLI 和 Web SAPI 的 PHP 配置完全独立，必须单独验证 CLI 版本
laravel-admin 对应 Laravel 版本隐含的 PHP 要求
laravel-admin 本身不锁死 PHP 版本，但它依赖的 laravel/framework 才是关键。查看你的 composer.json 中 "laravel/framework" 的版本：
-
"^6.0"→ 要求 PHP >= 7.2.5（但 laravel-admin 最新稳定版已不兼容 Laravel 6） -
"^8.0"→ 要求 PHP >= 7.3.0（安全底线） -
"^10.0"或"^11.0"→ 分别要求 PHP >= 8.0 和 >= 8.2；若你本地是 PHP 8.1，装 laravel-admin + Laravel 11 就会直接报Root composer.json requires php ^8.2
别只看 laravel-admin 文档写的“支持 Laravel 5.5+”，得顺着它的 composer.json 里 require 字段往深查一级依赖。
跳过 PHP 校验时，只关 php，别关全部
临时调试想快速装上？用 --ignore-platform-req=php，不是 --ignore-platform-reqs：
-
composer require encore/laravel-admin --ignore-platform-req=php：只跳过 PHP 版本检查，扩展（mbstring、openssl）仍会被校验，装完大概率能跑 -
--ignore-platform-reqs：连ext-gd、ext-xml都跳过，结果可能装完php artisan admin:install就报Class 'DOMDocument' not found - CI/部署环境绝对禁用
--ignore-platform-reqs，它会掩盖真实缺失项，上线后 500 错误才暴露
扩展缺失比 PHP 版本更常导致静默失败
laravel-admin 安装过程不报错，但执行 php artisan admin:install 时卡住或报错，90% 是扩展没开：
- 必装扩展：
mbstring、openssl、tokenizer、xml、ctype、json - 验证命令：
php -m | grep -E 'mbstring|openssl|xml'，Linux/macOS 下缺哪个就装哪个（如 Ubuntu PHP 8.2：sudo apt install php8.2-mbstring php8.2-xml） - Windows 用户注意：XAMPP/WAMP 的
php.ini有两个，CLI 用的是php --ini输出的那个，不是 Apache 目录下的那个
PHP 版本只是入场券，扩展才是入场后能干啥的权限卡。很多人卡在“装完了却跑不起来”，其实是 php -m 没真正跑通。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
