laragon配laravel最省事方式是用quick create功能,自动创建项目、拉取框架、配置域名(如myshop.test);但需确保apache/mysql已启动、php版本≥8.1、手动执行php artisan key:generate,并新建匹配的数据库。

Laragon 配 Laravel 最省事的方式就是用它的 Quick Create(快速创建) 功能,不用手动装 Composer、敲命令、配虚拟主机,点几下就能跑起一个可访问的 Laravel 项目。关键不是“能不能配”,而是“怎么让 Quick Create 真正生效并避免踩坑”。
Quick Create 是什么?它到底做了什么
这是 Laragon 内置的一键项目生成器,点击菜单 → “Quick Create” → 选 “Laravel”,它会自动:
- 在
C:\laragon\www\下新建对应文件夹(比如你输myshop,就建www/myshop) - 调用
composer create-project laravel/laravel拉取最新稳定版 Laravel(或指定版本) - 自动生成
.env文件,并预填数据库默认配置(DB_USERNAME=root,DB_PASSWORD=) - 自动启用虚拟主机:项目名即域名,如
myshop.test
为什么点了 Quick Create 却打不开 myshop.test?
常见卡点不在 Laravel 本身,而在 Laragon 的底层状态和权限链:
- Apache/MySQL 没启动:右下角托盘图标状态栏必须显示绿色 “Running”,否则域名解析和 PHP 执行都失效
- PHP 版本不匹配:Laravel 10 要求 PHP ≥ 8.1,而 Laragon 新装可能默认是 8.0 或 7.4;进设置 → PHP → 切换更高版本并重启服务
-
APP_KEY 缺失或未生成:Quick Create 不会自动执行
php artisan key:generate;若首页报错 “No application encryption key has been specified”,就进终端运行该命令 -
storage 权限问题(Windows 少见但非零):极少数情况下
storage/logs不可写,导致白屏;可右键文件夹 → 属性 → 安全 → 给当前用户“完全控制”
如何用 Quick Create 搭配已有代码(非全新拉取)
如果你手头已有完整的 Laravel 项目文件(含 vendor、.env、database/migrations),不要用 Quick Create 创建新项目再覆盖,而应:
- 把整个项目文件夹直接放进
C:\laragon\www\your-site - 确保
.env中APP_URL=http://your-site.test,且数据库名与你准备创建的库一致 - 打开 Laragon 终端 → 进入该项目目录 → 手动运行:
composer install→php artisan key:generate→php artisan migrate - 刷新
http://your-site.test即可
Quick Create 后还要做什么?三步收尾动作
哪怕页面出来了,也不代表环境真正 ready。务必补上这三步:
-
检查
.env数据库配置是否生效:改完DB_DATABASE后,要进 HeidiSQL 新建同名数据库,否则migrate会失败 -
确认 Artisan 命令可用:在 Laragon 终端里输入
php artisan tinker,能进入交互界面才算 PHP + Laravel 核心加载正常 -
验证静态资源路径:如果 CSS/JS 404,大概率是用了
mix()但没运行npm install && npm run dev;前端资源需单独构建











