Laravel 11 对底层环境有硬性要求，不满足会直接报错 Your requirements could not be resolved。

  • ‌PHP 版本必须 ≥ 8.2‌

    • ‌检查方法‌：终端运行 php -v。

    • ‌注意‌：推荐使用 ‌PHP 8.2‌ 或 ‌8.3‌。

    • ‌避坑‌：‌严禁使用 PHP 8.4‌（截至 2026 年，部分依赖包如 fruitcake/php-cors 在 PHP 8.4 下可能存在稳定性冲突或元数据未同步问题，导致 minimum-stability 报错）。如果当前是 8.1 或更低，必须升级。

  • ‌Composer 版本必须 ≥ 2.5（推荐 3.x）‌

    • ‌检查方法‌：终端运行 composer --version。

    • ‌原因‌：Laravel 11 的依赖解析机制依赖 Composer 2.5+ 的新特性。如果版本低于 2.5，会静默忽略某些约束或解析失败。

    • ‌升级命令‌：composer self-update

2. 检查缺失的 PHP 扩展

如果 PHP 版本正确但仍报错，通常是缺少必要扩展。Laravel 11 必需以下扩展：
mbstring, openssl, pdo, tokenizer, xml, ctype, json, curl

  • ‌检查方法‌：运行 php -m，查看列表中是否包含上述扩展。

3. 网络与镜像源问题（国内用户必做）

如果报错包含 Connection timed out、Resolving dependencies 卡死，或 no matching package found，通常是 Packagist 官方源连接不畅或国内镜像同步延迟。

  • ‌切换为腾讯云镜像（推荐，同步速度快且稳定）‌：

    bashcomposer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/

  • ‌或者切换回官方源（如果镜像报“包不存在”）‌：
    有些国内镜像会过滤 dev 分支或不稳定版本，导致 Laravel 11 的某些依赖（如 laravel/tinker 的特定小版本）找不到。此时应临时切回官方源：

    bashcomposer config -g --unset repos.packagist

  • ‌清理缓存后重试‌：

    bashcomposer clear-cache
composer install --no-interaction --prefer-dist

下载命令

composer create-project laravel/laravel uerp_api