Windows 下 Laravel 环境搭建：从小白到部署成功

如果你是一名开发者，想在 Windows 系统上开始学习或使用 Laravel 框架，那么一个稳定、易用的本地开发环境是第一步。很多新手在这一步就被各种报错劝退。别担心，这篇文章将手把手带你完成 Windows 下的 Laravel 安装，从零开始，直到看到“Laravel”的欢迎页面。

一、环境准备：安装“三件套”

Laravel 运行需要三个核心组件：PHP、Composer 和数据库。我们推荐使用集成的安装包，避免手动配置的繁琐和出错。

1. 安装 PHP 环境（推荐使用 XAMPP）

对于新手来说，单独安装和配置 PHP 扩展、Apache 非常麻烦。XAMPP 是一个集成了 Apache、PHP、MySQL 等组件的免费软件包，一键安装，省时省力。

操作步骤：

下载： 访问 Apache Friends 官网，下载适用于 Windows 的 XAMPP 安装程序。建议选择 PHP 版本为 7.4 或 8.0 以上的版本，以兼容最新的 Laravel。
安装： 运行安装程序。安装路径强烈建议使用纯英文路径，例如 D:\xampp，避免因中文路径导致的各种奇怪问题。
启动： 安装完成后，打开“XAMPP 控制面板”。点击 Apache 和 MySQL 模块旁边的 “Start” 按钮。当旁边的状态指示灯变成绿色，就表示服务启动成功了。
验证 PHP：
- 在 XAMPP 的安装目录下（如 D:\xampp），找到 htdocs 文件夹。
- 在里面新建一个文本文件，重命名为 test.php。
- 用记事本打开，写入代码：``。
- 打开浏览器，访问 http://localhost/test.php。
- 如果能看到一个显示 PHP 版本和配置信息的页面，恭喜你，PHP 环境配置成功！

2. 安装 Composer

Composer 是 PHP 的依赖管理工具，Laravel 就是通过它来创建和管理的。

操作步骤：

下载： 前往 Composer 官网，下载 Windows 安装程序 Composer-Setup.exe。
安装： 运行安装程序。在“选择PHP”这一步非常关键！你需要手动指定 PHP 解释器的路径。点击浏览，找到你 XAMPP 安装目录下的 php.exe，通常是 D:\xampp\php\php.exe。之后的所有步骤都保持默认，点击“下一步”直到完成。
验证： 按下 Win + R 键，输入 cmd 打开命令提示符。输入命令 composer --version 并回车。如果正确显示 Composer 的版本号，说明安装成功。

二、安装 Laravel 项目

环境准备好后，我们就可以“召唤” Laravel 了。

操作步骤：

打开命令行： 同样使用 Win + R 输入 cmd 打开命令提示符。或者，在 XAMPP 的 htdocs 文件夹内，按住 Shift 键并点击鼠标右键，选择“在此处打开 Powershell 窗口”，这样你的命令行起点就直接在项目目录了，更方便。
使用 Composer 创建项目： 输入以下命令并回车：
```
composer create-project laravel/laravel my-laravel-app
```
- my-laravel-app 是你的项目文件夹名称，可以随意改成你喜欢的名字，比如 myblog。
- 这个命令会从云端拉取 Laravel 框架和所有依赖包，过程可能需要几分钟，请保持网络通畅。
进入项目目录： 创建完成后，输入命令进入你的项目文件夹：
```
cd my-laravel-app
```
启动内置开发服务器： Laravel 自带了一个轻量级的开发服务器。在项目目录下运行：
```
php artisan serve
```
你会看到类似 Development server started at http://127.0.0.1:8000 的提示。

三、验证与访问

打开你的浏览器（Chrome， Firefox等）。
在地址栏输入上一步提示的地址：http://127.0.0.1:8000 或 http://localhost:8000。
如果一切顺利，你将会看到 Laravel 框架默认的欢迎页面，上面有醒目的 “Laravel” 标志和一些链接。

恭喜！你已经成功在 Windows 上安装了 Laravel 开发环境！

四、常见问题与避坑指南

问题：执行 composer create-project 时卡住或报错。
- 原因： 通常是网络问题，连接 Composer 的官方仓库速度慢或不稳定。
- 解决： 为 Composer 配置中国镜像。在命令行中全局执行：
```
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
```
  然后再重试创建项目的命令。
问题：运行 php artisan serve 提示 “php 不是内部或外部命令”。
- 原因： 系统找不到 PHP 程序。说明 PHP 没有正确添加到系统环境变量，或者你安装的 PHP 路径不对。
- 解决： 确保你通过 XAMPP 安装，并且 Composer 安装时正确指向了 XAMPP 下的 php.exe。你也可以在 XAMPP 的控制面板里，直接使用它的 Shell 来执行命令。
问题：访问 localhost:8000 显示无法连接。
- 原因1： 开发服务器没有启动。确认命令行窗口没有关闭，并且 php artisan serve 命令正在运行。
- 原因2： 端口冲突。8000 端口可能被其他程序（如迅雷、某些云盘）占用。
- 解决： 可以指定另一个端口启动服务器，例如：
```
php artisan serve --port=8080
```
  然后访问 http://localhost:8080 即可。
问题：后续如何连接数据库？
- Laravel 的数据库配置文件在项目根目录的 .env 文件中。你需要用记事本等编辑器打开它，修改以下配置项，使其与你的 XAMPP 数据库信息匹配：
```
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel  // 你的数据库名
DB_USERNAME=root     // XAMPP默认用户名
DB_PASSWORD=         // XAMPP默认密码为空
```
  在 XAMPP 控制面板点击 MySQL 的 “Admin” 按钮，会打开 phpMyAdmin，你可以在那里创建新的数据库。

五、下一步优化建议

使用集成开发环境（IDE）： 强烈推荐使用 PHPStorm 或 Visual Studio Code（安装 PHP 扩展）来编写 Laravel 代码，它们能提供代码提示、语法高亮、错误检查等功能，极大提升开发效率。
版本管理工具： 学习使用 Git 来管理你的代码版本，并注册一个 GitHub 或 Gitee 账号来托管你的项目。
深入学习： 访问 Laravel 官方文档，这是最权威、最全面的学习资源。从路由（Routing）、控制器（Controller）、模型（Model）和视图（View）这些核心概念开始学起。

现在，你的 Laravel 开发之旅已经正式在 Windows 上启航了。动手实践是学习编程的最佳方式，从修改一个简单的欢迎页面开始，逐步构建你的第一个 Web 应用吧！