laravel官网教程下载与安装入门指南

刚接触 Laravel 时，最让人头大的往往不是复杂的业务逻辑，而是还没写代码就遇到的环境报错。比如打开终端输入 laravel new 却提示命令不存在，或者运行项目时发现缺少某个 PHP 扩展。这种“出师未捷身先死”的感觉确实挺劝退的。

其实，Laravel 的安装并没有想象中那么神秘，核心就在于两个工具：PHP 环境和 Composer 包管理器。只要这两样东西就位，剩下的步骤就像搭积木一样简单。我们不需要去官网下载什么巨大的安装包，现代 PHP 开发更倾向于通过命令行来管理依赖。

检查并准备 PHP 环境

Laravel 对 PHP 版本有明确要求，目前主流版本通常需要 PHP 8.1 或更高。在动手之前，先打开你的终端（Windows 上是 CMD 或 PowerShell，Mac 上是 Terminal），输入以下命令查看当前版本：

php -v

如果返回了版本号且大于 8.1，那就可以直接跳过这一步。如果提示“不是内部或外部命令”，说明你还没安装 PHP，或者环境变量没配好。这时候建议去 PHP 官网下载对应的 Windows 二进制文件，或者在 Mac 上使用 Homebrew 安装。

除了版本，Laravel 还需要一些特定的扩展支持，如 BCMath、Ctype、Fileinfo、JSON、Mbstring、OpenSSL、PDO、Tokenizer 和 XML。大多数集成环境（如 XAMPP、MAMP 或 Laragon）已经默认开启了这些扩展，但如果是手动安装的 PHP，可能需要检查 php.ini 文件，确保相关行前面的分号已被去掉。

在终端中输入 php -v 确认版本是否符合要求

安装 Composer 依赖管理器

Composer 是 PHP 世界的 npm，它是安装 Laravel 的关键。不要试图去 GitHub 下载 Laravel 的源码压缩包然后手动解压，那样你会失去自动更新和依赖解析的能力。

访问 getcomposer.org 下载最新版的 Composer 安装程序。Windows 用户直接运行 .exe 安装向导，它会自动帮你配置环境变量；Mac 和 Linux 用户则可以通过终端指令一键安装。安装完成后，再次在终端输入：

composer --version

看到版本号输出，就说明这把“钥匙”已经到手了。Composer 不仅能下载 Laravel，还能帮你解决后续项目中各种库的版本冲突问题，是 PHP 开发者必须掌握的工具。

创建第一个 Laravel 项目

环境就绪后，我们就可以正式“下载”Laravel 了。这里说的下载，实际上是通过 Composer 从远程仓库拉取代码并初始化项目。找一个你打算存放代码的文件夹，在终端中执行：

composer create-project laravel/laravel my-first-app

这里的 my-first-app 是你的项目名称，可以随意替换。执行这条命令后，终端会开始滚动大量的下载日志。这个过程取决于你的网络速度，因为 Composer 需要从全球服务器下载 Laravel 核心及其所有依赖包。

使用 composer create-project 命令拉取项目依赖

等待进度条走完，你会发现当前目录下多了一个名为 my-first-app 的文件夹。这就是一个完整的、可运行的 Laravel 应用骨架。你不需要再去官网找什么“完整版”或“精简版”，Composer 拉取的就是标准发行版。

启动本地开发服务器

项目创建好后，很多新手会纠结于如何配置 Nginx 或 Apache。其实 Laravel 内置了一个基于 PHP 的开发服务器，非常适合学习和调试阶段使用。

进入项目目录：

cd my-first-app

然后启动服务：

php artisan serve

终端会显示类似 Server running on http://127.0.0.1:8000 的提示。打开浏览器访问这个地址，如果你看到了 Laravel 标志性的欢迎页面，那就恭喜你了，安装大功告成。

浏览器中成功显示的 Laravel 欢迎界面

这个内置服务器虽然不适合生产环境，但它能自动检测代码变化并重新加载，极大地提升了开发效率。如果你需要修改端口，可以加上 --port=8080 参数。

遇到问题的排查思路

如果在安装过程中遇到红色报错，别慌，通常只有几种情况。最常见的是权限问题，特别是在 Mac 或 Linux 上，确保你对目标文件夹有写入权限。其次是网络问题，如果 Composer 下载极慢或超时，可以尝试切换国内镜像源，比如阿里云或腾讯云提供的 Packagist 镜像。

另外，注意观察报错信息中的关键词。如果是 missing extension，就回去检查 PHP 扩展；如果是 memory limit，则在 php.ini 中调大 memory_limit 的值。Laravel 的社区非常活跃，绝大多数安装问题都能在网上找到现成的解决方案。

现在，你的开发环境已经搭建完毕，接下来就可以深入阅读官方文档，开始探索路由、控制器和视图的奥秘了。记住，好的开始是成功的一半，保持耐心，享受编码的乐趣。