怎样使用Laragon7.0配置Laravel9框架-php教程-PHP中文网

laragon 7.0可快速配置laravel 9：1.确认php≥8.1；2.用quick app或composer create-project创建项目；3.配置.env（db_user=root、空密码）并执行php artisan key:generate；4.勾选启动，访问http://myapp.test。

怎样使用laragon7.0配置laravel9框架

Laragon 7.0 是 Windows 下轻量、开箱即用的 PHP 开发环境，对 Laravel 9 支持良好。它自带 PHP 8.0+（默认含 8.1 或 8.2）、Composer、MySQL、Redis 等组件，无需手动配置 Apache/Nginx 和 PATH，非常适合快速搭建 Laravel 9 项目。

下面分四步讲清楚怎么用 Laragon 7.0 配置 Laravel 9：

Laravel

避免常见的Laravel错误：N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载

确认 Laragon 版本与 PHP 环境
Laravel 9 要求 PHP ≥ 8.0.2，而 Laragon 7.0 默认集成 PHP 8.1.x（部分新版含 8.2）。
打开 Laragon → 点击菜单栏 PHP → Version，确认当前启用的是 8.1 或更高版本。
若显示 PHP 7.x 或版本过低：

点击 PHP → Download，选择 php-8.1.x-Win32-vs16-x64.zip（推荐 Thread Safe 版）
下载解压后，Laragon 会自动识别并添加到版本列表，选中启用即可
运行 php -v 和 php -m | findstr "openssl pdo mbstring tokenizer xml ctype json"，确保关键扩展已启用

用 Composer 创建 Laravel 9 项目
Laragon 自带全局 Composer，无需额外安装。
操作步骤：

打开 Laragon → 点击菜单栏 Quick App → Laravel（此选项默认拉取最新稳定版 Laravel，即 9.x）
或手动执行（推荐更可控）：
- 在 Laragon 的 www 目录下（如 D:\laragon\www），右键 → Open Terminal Here
- 运行命令：
```
composer create-project laravel/laravel myapp --prefer-dist
```
- 等待安装完成，myapp 即为项目名（可自定义）
安装完成后，Laragon 会自动检测新文件夹，几秒后在主界面左侧面板出现 myapp 站点

配置 .env 与数据库连接
进入项目根目录（如 D:\laragon\www\myapp），执行：

复制 .env.example 并重命名为 .env
用编辑器打开 .env，修改数据库配置（Laragon 默认 MySQL 用户为 root，密码为空）：
```
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=myapp
DB_USERNAME=root
DB_PASSWORD=
```
生成应用密钥（必须！否则报错）：
```
php artisan key:generate
```
可选：创建对应数据库（Laragon 自带 PhpMyAdmin，访问 http://localhost/phpmyadmin → 新建数据库 myapp，字符集选 utf8mb4_unicode_ci）

启动服务并验证

在 Laragon 主界面，勾选 myapp 左侧复选框，点击 Start All（或右键 → Start）
Laragon 自动配置虚拟主机，访问 http://myapp.test 即可看到 Laravel 欢迎页
若提示 500 Server Error 或白屏：
- 检查 storage/ 和 bootstrap/cache/ 目录是否可写（Laragon 默认权限正常，一般无需手动改）
- 查看 storage/logs/laravel.log 获取具体错误
- 常见问题：.env 中 APP_KEY 未生成、APP_URL 写成 http://localhost（建议保持默认 http://myapp.test）

不复杂但容易忽略细节，按这四步走基本一次成功。