Composer安装Laravel框架步骤_快速搭建开发环境基础【全攻略】

Lara vel项目创建失败主因是PHP版本或扩展缺失，非命令本身问题；需确认PHP≥8.2（L11）或≥8.1（L10），并启用mbstring、openssl、pdo、tokenizer、xml扩展，再用--prefer-dist和精确版本号安装，最后验证artisan serve、.env及app()->version()。

说起来，composer create-project lara vel/lara vel 这条命令本身简单直接，但真正执行时，十有八九的问题都出在它背后的环境上——PHP版本对不上、扩展没装好，或者权限不足。命令本身，反倒很少是罪魁祸首。

PHP 版本和必需扩展必须提前确认

这事儿得先拎清楚：Lara vel 11 要求 PHP 版本至少是 8.2，而 Lara vel 10 则要求 ≥ 8.1。光在终端里敲个 php -v 看看版本号可不够，更关键的是用 php -m 和 php --ini 来确认实际加载了哪些扩展和配置文件。以下几个“翻车点”尤其常见：

• 五个核心扩展——mbstring、openssl、pdo、tokenizer、xml——缺了任何一个，create-project 过程都会中断，并抛出类似 Class 'Mbstring' not found 的错误。
• Mac 用户如果通过 Homebrew 安装 PHP，经常会因为 php.ini 的路径问题导致扩展没被正确加载；而 Linux 用户在用 apt 安装后，往往需要手动执行一下 sudo phpenmod mbstring 这样的命令来启用模块。
• Windows 平台上的 XAMPP 或 WAMP 自带 PHP，但版本可能过低。别完全相信控制面板上显示的“PHP版本”，最靠谱的方法还是在终端里运行 where php 和 php -v，看看实际调用的是哪个。

composer create-project 的关键参数和路径陷阱

默认的命令格式是 composer create-project lara vel/lara vel my-project，但在实际开发中，加上几个参数会让过程更顺畅。建议使用 --prefer-dist 参数，它会跳过完整的 Git 克隆，直接下载 ZIP 包，速度更快。同时，显式指定 Lara vel 版本号可以避免拉到不稳定的预发布版：

• 要安装 Lara vel 11，使用：composer create-project lara vel/lara vel:^11.0 my-project --prefer-dist
• 要安装长期支持版 Lara vel 10，使用：composer create-project lara vel/lara vel:^10.0 my-project --prefer-dist
• 项目名称的命名也有讲究，避免使用大写字母或空格，否则后续运行 artisan 命令时可能会遇到路径解析异常。推荐全小写加中划线的格式，比如 my-api-backend。
• 如果当前目录权限不足（例如在 Linux 系统下的 /var/www 目录），不要强行使用 sudo 来执行 composer 命令。稳妥的做法是先 cd 到一个用户拥有写权限的目录，再运行安装命令。

安装完成后必须立刻验证的三件事

先别急着开始写业务代码。安装成功只是第一步，确保基础环境真正能跑起来，才是关键。下面这三项验证，建议一步都不要省：

• 进入项目目录，执行 php artisan serve。如果看到终端输出 Starting Lara vel development server，并且能在浏览器中打开 http://127.0.0.1:8000 看到 Lara vel 的默认欢迎页，这才算通过了第一关。
• 检查项目根目录下的 .env 文件是否已经生成。更重要的是，看看里面的 APP_KEY 是不是还是一串 SomeRandomString。如果是，说明安装后 php artisan key:generate 命令没有自动执行成功，需要你手动运行一次来生成有效的应用密钥。
• 运行 php artisan tinker 进入交互式命令行，输入 app()->version() 并回车。如果能正确返回 Lara vel 的版本号，说明应用容器和核心服务加载正常。如果这里报错，比如提示 Class 'PDO' not found，那问题又绕回去了——PDO 扩展仍然没有启用。

说到底，真正卡住开发者的，往往不是“安装命令怎么写”，而是那些底层环境是否就位：PHP模块装对了吗？.env 配置文件被意外覆盖了吗？artisan 命令启动时读取的又是哪个 php.ini 文件？这些问题，不仔细查看日志和实际输出，光靠反复重装 Composer，是解决不了的。