Laravel 正常运行需满足 PHP ≥8.2 且启用 mbstring、openssl、pdo、tokenizer、xml、ctype、json 七扩展；验证后安装 Composer，配置阿里云镜像，再执行 create-project、key:generate 和 serve 完成初始化。
要让 Laravel 正常运行，必须先让 PHP 环境满足硬性门槛：PHP 版本不能低于 8.2，且 mbstring、openssl、pdo、tokenizer、xml、ctype、json 这七个扩展缺一不可；少一个，composer create-project 就会在解析依赖时直接中断，报错信息看似语法错误，实则全是环境缺失的伪装。
确认 PHP 版本与核心扩展是否启用
第一步：在终端中执行 php -v，确保输出的版本号是 8.2 或更高（如 8.2.24、8.3.12）。低于 8.2 的任何版本都无法安装 Laravel 11。
第二步：运行 php -m | grep -E 'mbstring|openssl|pdo|tokenizer|xml|ctype|json'，检查这七项是否全部出现在返回列表中。若某项缺失，后续所有操作都会失败。
Windows 用户注意：XAMPP/MAMP 自带的 PHP 可能只启用了 Apache 模块下的扩展，而 Composer 调用的是 CLI 版本（路径通常是 C:\xampp\php\php.exe），请务必用该路径下的 php.exe 执行上述命令，否则检查结果无效。打开对应目录下的 php.ini，取消掉 ;extension=mbstring 这类行前的分号，保存后重启命令行再试。
立即学习“PHP免费学习笔记（深入）”；
安装并验证 Composer 工具
从官网下载 Composer-Setup.exe（Windows）或用脚本安装（macOS/Linux）：curl -sS https://getcomposer.org/installer | php → sudo mv composer.phar /usr/local/bin/composer。
安装完成后，立即运行 composer --version。如果提示 command not found: composer，说明系统没识别到可执行文件路径，需手动将 Composer 所在目录加入 $PATH（macOS/Linux）或环境变量（Windows）。
这一步操作起来很简单，直接把文件拖进去就行——但别跳过校验。没看到版本号就继续下一步，等于拿空枪上战场。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
配置国内镜像源避免超时失败
方法一：全局配置阿里云镜像（推荐长期使用）
执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。此后所有项目都走该源，无需重复设置。
方法二：单次安装指定镜像（适合临时调试或 CI 环境）
在 create-project 命令后加 --repository=https://mirrors.aliyun.com/composer/ 参数，例如：composer create-project laravel/laravel myapp --repository=https://mirrors.aliyun.com/composer/。
【注意】 别用已停用的 https://packagist.phpcomposer.com，该镜像自 2025 年底起失效，使用会导致 Could not fetch packages 或 zlib_decode(): data error。
执行 Laravel 创建并完成初始化
① 运行 composer create-project laravel/laravel myapp。项目名 myapp 不能含空格或中文，否则 artisan 命令会报错。
② 进入项目目录：cd myapp。
③ 生成应用密钥：php artisan key:generate。这一步不可跳过，否则访问时会提示 Application key not set，页面空白。
④ 启动内置服务器：php artisan serve。默认监听 http://127.0.0.1:8000，浏览器打开即可看到 Laravel 欢迎页。
