如何在本地环境完整重建并运行一个 Laravel 网站（含数据库）-php教程-PHP中文网

如何在本地环境完整重建并运行一个 Laravel 网站（含数据库）

本文详细讲解如何仅凭本地已有的 laravel 项目文件，在 windows 上使用 laragon 快速搭建可运行的本地开发环境，包括数据库导入、迁移执行与服务启动全流程。

当你接手一个 Laravel 网站却无法访问原服务器时，只要拥有完整的项目文件（含 app/、database/、.env、composer.json 等），就完全可以在本地实现 100% 功能复现——关键在于正确还原运行时依赖、配置和数据状态。

✅ 基础准备：安装 Laragon（推荐 Windows 用户）

Laragon 是专为 Windows 设计的轻量级集成开发环境，内置 Apache/Nginx、PHP、MySQL 和 phpMyAdmin/HeidiSQL，开箱即用，比手动配置 WAMP 或 Docker 更高效（尤其对非 DevOps 背景的开发者）。
? 下载地址：https://www.php.cn/link/c801fb350a465fe48197dda942b8091a
安装后启动 Laragon，确保系统托盘中显示绿色「Running」状态。

? 步骤一：部署项目代码

在 C:\laragon\www\ 目录下新建一个空文件夹（如 my-laravel-site）；
将你手头的全部 Laravel 文件（务必包含隐藏文件，尤其是 .env 和 .gitignore）完整复制进去；
⚠️ 注意：若原 .env 中含有线上数据库密码或 API 密钥，请立即修改为本地安全值（如 DB_PASSWORD= 留空或设为 root），并确认 APP_KEY 存在（若缺失，后续需生成）。

?️ 步骤二：初始化数据库

在 Laragon 主界面点击 MySQL → HeidiSQL（或通过菜单打开）；
连接默认 localhost（用户 root，密码为空）；
新建数据库：右键「localhost」→「Create new database…」→ 输入库名（如 laravel_site），字符集选 utf8mb4_general_ci；
若你有原站导出的 SQL 备份（如 backup.sql），可在 HeidiSQL 中右键该数据库 → 「Execute SQL file…」一键导入；
若无备份，仅靠迁移文件重建结构：跳至下一步执行 php artisan migrate。

⚙️ 步骤三：安装依赖并运行迁移

以管理员权限打开 Laragon 自带的终端（点击左上角 Terminal → CMD 或 Git Bash）：

Docker Compose Optimizer

优化 Docker Compose 配置，适用于开发和生产环境——审计服务、网络、卷、健康检查和资源管理。

下载

# 进入项目目录
cd C:\laragon\www\my-laravel-site

# 安装 PHP 依赖（确保已安装 Composer）
composer install

# 生成应用密钥（若 .env 中 APP_KEY 为空）
php artisan key:generate

# 执行数据库迁移（创建表结构）
php artisan migrate

# 【可选】填充测试数据（如有 seeders）
php artisan db:seed

▶️ 步骤四：启动服务并验证

回到 Laragon 主界面，点击右上角 Reload 按钮（或按 Ctrl+R）；
Laragon 会自动识别 Laravel 项目并启用对应虚拟主机（默认访问地址：http://my-laravel-site.test）；
打开浏览器访问该地址，应看到 Laravel 欢迎页或原站首页；
如遇 500 错误，请检查 storage/logs/laravel.log，常见原因包括：
- .env 配置错误（如 DB_DATABASE 名称不匹配）；
- storage/ 和 bootstrap/cache/ 目录未写入权限（Laragon 下通常无需手动 chmod，但可右键文件夹 → 属性 → 安全 → 编辑权限）；
- PHP 版本不兼容（Laragon 可在 Settings → PHP 中切换版本，建议匹配原站 composer.json 中的 php 约束）。