最省事路径是PHPStudy+laravel/installer+正确环境变量三者对齐,5分钟内可完成;需确认WNMP模式、PHP8.2+及必要扩展启用、Nginx与MySQL启动成功,并将Composer全局bin路径加入PATH,重载Nginx配置指向public目录,首次访问前执行php artisan key:generate。

laravel new 能跑起来,就别碰手动配置。最省事的路径是:PHPStudy + laravel/installer + 正确的环境变量,三者对齐,5分钟内可完成。
为什么不用 XAMPP/WAMP 或纯手动装 PHP?
它们不是不能用,而是容易卡在三个地方:php_openssl.dll 没启用、composer 找不到 php.exe、PATH 里混进多个 PHP 版本导致命令冲突。XAMPP 的 Apache 默认不支持 Laravel 的 URL 重写(.htaccess 生效需额外开 mod_rewrite),而 WAMP 切换 PHP 版本后常要重启整个服务——这些都不是“省事”该有的体验。
PHPStudy 启动后必须确认的三件事
装好 PHPStudy(推荐 2024+ 版,已内置 PHP8.2)后,打开主界面,做以下检查:
- 右上角切换模式为 WNMP(不是 WAMP),否则 Nginx 不会启动
- PHP 版本选中
php-8.2.x(Laravel 11 要求 PHP ≥ 8.2),点击“设置”确认extension=openssl、extension=pdo_mysql、extension=mbstring这三行在php.ini中未被注释 - 点“服务”→ 启动
Nginx和MySQL,状态栏显示绿色才表示真正就绪
composer global require laravel/installer 之后还不能用?
这是 Windows 上最常被忽略的一步:全局安装器生成的可执行文件不在系统 PATH 里。你需要手动把这串路径加进环境变量:
%USERPROFILE%\AppData\Roaming\Composer\vendor\bin
加完后,**关掉所有已打开的 CMD/PowerShell/Cmder 窗口,重新开一个**,再运行:
laravel new myapp
如果报错 'laravel' is not recognized,说明 PATH 没生效或窗口没重启;如果卡在 Installing laravel/laravel (v11.x) 超过 2 分钟,大概率是 Composer 源没切国内镜像——立刻执行:
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
项目跑起来前,Nginx 配置不能跳过
PHPStudy 的 WNMP 模式默认把网站根目录指向 D:\phpstudy_pro\WWW,但 Laravel 项目入口在 public/ 子目录。直接访问 http://localhost/myapp 会 404。你有两个选择:
- 把
myapp整个目录移到D:\phpstudy_pro\WWW下,然后在 PHPStudy → 网站 → 添加站点,绑定域名(如myapp.test),根目录填D:\phpstudy_pro\WWW\myapp\public - 更轻量的做法:不加站点,直接改 Nginx 配置。编辑
D:\phpstudy_pro\Extensions\nginx1.25.2\conf\vhost\default.conf,把root行改成:root D:/phpstudy_pro/WWW/myapp/public;,然后点 PHPStudy 界面的“重载配置”
改完立刻能用 http://localhost 访问,不需要改 hosts、不需要配 SSL、不依赖 artisan serve —— 这才是“省事”的终点。
注意:Laravel 11 默认禁用 APP_KEY 自动生成,首次访问前务必进项目目录执行 php artisan key:generate,否则页面空白且无报错提示。


















