重装Composer后需手动重建Laravel项目:先确认PHP≥8.1及mbstring/openssl/pdo等扩展启用,配置阿里云镜像源https://mirrors.aliyun.com/composer/,再用composer create-project laravel/laravel myapp "11.*"创建项目,最后复制.env、生成key并设storage可写。

重装 Composer 后,Laravel 并不会自动恢复——它只是依赖工具,不是系统级组件。你需要重新安装 Laravel 安装器或直接用 create-project 创建项目,关键在于确认 PHP 环境、镜像源和权限是否就绪。
检查并修复基础环境
重装 Composer 后常被忽略的是 PHP 和扩展状态:
- 运行
php -v确认 PHP 版本 ≥ 8.1(Laravel 10+ 要求),且不是“不是内部命令”错误; - 运行
php -m | findstr "mbstring openssl pdo tokenizer xml"(Windows)或php -m | grep -E "mbstring|openssl|pdo|tokenizer|xml"(macOS/Linux)验证必需扩展已启用; - 如果用 PHPStudy/XAMPP 等集成环境,确保当前启用的 PHP 版本已在系统 PATH 中(右键桌面“此电脑”→属性→高级系统设置→环境变量→Path 检查路径是否包含 php.exe 所在目录)。
配置国内镜像源(必须做)
不设镜像,create-project 极易卡在 “Installing dependencies” 或超时失败:
- 执行命令:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效:运行
composer config -g repo.packagist,输出应为阿里云地址; - 若之前失败过,删掉残留的半成品项目文件夹再重试,避免缓存干扰。
两种方式任选其一创建 Laravel 项目
推荐直接使用 create-project,它更轻量、无全局依赖冲突,且支持指定版本:
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
-
方式一(推荐):用 create-project 直接拉项目
在目标目录(如E:\LaravelWork)打开命令行,运行:composer create-project laravel/laravel myapp "11.*"
其中"11.*"表示安装 Laravel 11 最新稳定版(加引号防 shell 解析错误); -
方式二:重装 Laravel 安装器(可选)
运行composer global require laravel/installer;
然后把%USERPROFILE%\AppData\Roaming\Composer\vendor\bin加入系统 Path(需重启命令行);
再执行laravel new myapp。
安装后三件关键事
项目生成后立即执行以下操作,否则访问会报错或功能异常:
- 进入项目根目录,复制
.env.example为.env; - 运行
php artisan key:generate,生成并写入APP_KEY; - 确保
storage和bootstrap/cache目录可写(Windows 下一般默认可写;Linux/macOS 可能需chmod -R 775 storage bootstrap/cache)。
做完这些,运行 php artisan serve,浏览器打开 http://localhost:8000 就能看到 Laravel 欢迎页。整个过程不依赖旧配置,干净启动即可。










