laravel在windows powershell中安装的核心是先配好php(≥8.2,启用openssl、mbstring等扩展)和composer(推荐setup.exe安装并配置阿里云镜像),再用composer create-project创建项目,最后php artisan serve启动服务。

在 Windows PowerShell 中安装 Laravel,核心不是“直接装 Laravel”,而是配好底层环境后,用 Composer 创建项目。Laravel 本身没有独立安装包,它依赖 PHP 和 Composer 正常运行——这两者没配对,后续所有命令都会失败。
先确认 PHP 已正确安装并启用关键扩展
打开 PowerShell(**以管理员身份运行更稳妥**),执行:
php -v
必须看到 PHP 版本 ≥ 8.2(Laravel 11 要求),且不能报“不是内部命令”。若报错,说明 php.exe 没进系统 Path,或根本没装。
接着验证扩展是否启用:
php -m | findstr /i "openssl mbstring pdo tokenizer xml ctype json bcmath fileinfo zip curl"
上面列出的每一个模块名都应出现在输出中。缺任何一项,都要去 php.ini 里取消对应行前的分号,例如:
- extension=openssl
- extension=mbstring
- extension=zip(否则 create-project 解压会报 zlib_decode 错误)
改完保存,重启 PowerShell 再验证。
确保 Composer 可用并切换国内镜像
执行:
composer --version
有版本号才表示就绪。若失败,优先用官方 Composer-Setup.exe 安装(自动处理路径和权限)。手动安装容易因 UAC 权限导致写入失败。
装好后立即切阿里云镜像(2026 年主流推荐):
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
再顺手更新自身:
composer self-update
用 create-project 创建 Laravel 项目(推荐方式)
不建议用 laravel new(需额外全局安装 laravel/installer,版本易滞后)。直接在目标目录下运行:
cd D:\myapp<br>composer create-project laravel/laravel . --prefer-dist --no-interaction
注意末尾的 . 表示当前目录为项目根。加 --no-interaction 避免卡在交互提问。
成功后进入目录,生成密钥:
cd .\myapp<br>php artisan key:generate
启动服务并访问
Laravel 内置服务器默认绑定 127.0.0.1:8000,但 PowerShell 下有时需显式指定 host:
php artisan serve --host=127.0.0.1 --port=8000
启动后浏览器打开 https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a,看到 Laravel 欢迎页即成功。
如果打不开,检查 Windows 防火墙是否放行了该端口,或确认 .env 中 APP_URL=https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a 是否匹配。











