如何用Laragon搭Laravel？环境搭建全流程-php教程-PHP中文网

laragon搭laravel核心三步：一、安装并启用auto virtual hosts，确保apache/mysql绿色运行及必要php扩展；二、将项目置于c:\laragon\www\下直子目录；三、用heidisql建库、配好.env、执行composer install、key:generate、migrate，最后访问your-project-name.test。

如何用laragon搭laravel？环境搭建全流程

用 Laragon 搭 Laravel，核心就三步：装好 Laragon、放对项目、配通数据库。不用改 hosts、不手动配 vhost、不折腾 PHP 版本切换——Laragon 会自动处理这些。

一、安装 Laragon 并确认基础服务

从官网或 SourceForge 下载最新版 Laragon（推荐 WAMP 版），安装时勾选 Auto virtual hosts（自动虚拟主机）。安装完成后启动，系统托盘图标显示绿色即代表 Apache 和 MySQL 已就绪。右键托盘 → PHP → Check Extensions，确保以下扩展已启用：mbstring、openssl、pdo_mysql、tokenizer、xml、ctype、json、intl。若缺 intl（Windows 常见），可在 PHP 扩展列表中手动勾选。

二、把 Laravel 项目放进指定目录

将你的完整 Laravel 项目文件夹（含 artisan、composer.json、database/、.env 等）复制到：
C:\laragon\www\your-project-name\

注意：
• 不要放在子目录（如 www\test\myapp\），必须是 www 的直接子文件夹；
• 若项目是全新创建，用 Laragon 自带终端执行：
composer create-project laravel/laravel:^10.0 your-project-name（Laravel 10 是当前 LTS，兼容 PHP 8.1+）；
• 安装前建议先切国内镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。

三、配置数据库并运行迁移

打开 Laragon → 托盘 → MySQL → HeidiSQL，新建数据库，名称与 .env 中的 DB_DATABASE 一致（如 laravel_site），字符集选 utf8mb4_unicode_ci。

Laravel

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

下载

编辑项目根目录下的 .env 文件，确保关键项如下：

APP_ENV=local
APP_DEBUG=true
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_site
DB_USERNAME=root
DB_PASSWORD=（Laragon 默认 root 无密码）

在 Laragon 终端中进入项目目录，依次执行：

composer install（安装依赖）
php artisan key:generate（生成 APP_KEY，若 .env 中为空）
php artisan migrate（还原表结构）
php artisan db:seed（如有 seeders，可选）

四、启动并访问站点

回到 Laragon 主界面，点击 Start All（确保 Apache 和 MySQL 都是绿色运行状态）。浏览器访问：
http://your-project-name.test（自动域名）
或
http://localhost/your-project-name/public（传统路径）

看到欢迎页或首页即成功。若报错，优先检查：
• storage/logs/laravel.log 最新错误日志；
• .env 是否有拼写错误或多余空格；
• 执行过 php artisan config:clear（改完 .env 后必须清缓存才生效）。