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,并且能在浏览器中打开https://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,是解决不了的。
相关攻略
数据库连通性验证:从底层探测到生产环境避坑指南 数据库连接问题,可以说是后端开发中最常见也最令人头疼的“暗礁”之一。配置看起来都对,但应用就是连不上数据库,或者时好时坏。今天,我们就来聊聊在 Lara vel 框架下,如何精准、高效地验证数据库连通性,并避开那些容易踩的坑。 用 DB::connec
如何在 Lara vel 中向现有 GET URL 安全追加新查询参数 本文介绍在 Lara vel 中通过表单提交时,将新查询参数(如 degree_srch=4)无缝合并到当前 URL 已有参数(如 ?specialty_id=1)中的正确方法,避免覆盖原有参数。 在 Lara vel 项目中处
最准方法是直接执行SQL检查MorphTo关联:遍历comments等表,用LEFT JOIN或NOT IN验证commentable_type+commentable_id是否指向目标表真实且未软删除的主键,缺失则为脏数据;需补联合索引、绕过Eloquent加载、事务删除。 查出哪些 MorphT
Lara vel 引入 Vite 编译:不是“共存”,而是“替换” 在 Lara vel 项目中引入 Vite,首先要明确一个核心概念:这通常不是“引入”,而是一场彻底的“替换”。关键在于,你需要关闭并移除原有的 Lara vel Mix,否则两个构建工具会同时争夺资源,导致缓存爆炸、热更新(HMR
Lara vel API 登录失败排查指南:从配置到密码的深度检查 登录返回 401 但密码明明正确 遇到这种情况,先别急着怀疑密码。问题的症结,往往不在于密码本身,而在于认证的“关卡”没对上——也就是守卫(guard)配置。Lara vel 的 API 路由默认使用 api 守卫,这套机制默认不读
热门专题
热门推荐
英伟达显卡怎么设置发挥最大性能? 想让你的英伟达显卡火力全开,榨干每一分性能吗?无论是为了追求极致的游戏帧率,还是确保专业图形应用的流畅运行,正确的设置都至关重要。很多朋友手握着高性能显卡,却因为设置不当,没能享受到它应有的表现。别担心,下面这份详尽的设置指南,将带你一步步解锁显卡的全部潜力。 电脑
显卡温度过高怎么办?Win11系统下快速检测与降温指南 显卡温度异常升高是电脑用户常遇到的问题,不仅可能引发画面卡顿、显示花屏等故障,长期高温运行更会加速硬件老化,甚至导致显卡核心损坏。因此,定期监控显卡温度是维护电脑健康、保障稳定运行的关键环节。本文将详细介绍在Windows 11系统中,无需复杂
从Win7升级到Win10,这些关键点你把握住了吗? 近期,许多用户都在咨询如何将电脑操作系统从Windows 7平稳升级至Windows 10,并希望了解升级过程中有哪些常见陷阱需要规避。这确实是一个值得深入探讨的话题。今天,我们将系统性地梳理从Win7升级到Win10的全流程,重点解析那些至关重
360浏览器选中网页文字自动弹出复制选项怎么设置? 许多用户在使用360安全浏览器时,都非常依赖一个便捷功能:当您选中网页上的文字时,浏览器会自动弹出一个快捷工具条,提供“复制”、“翻译”、“搜索”等一键操作。这个划词工具条能极大提升浏览和资料处理的效率。如果您发现自己的浏览器突然失去了这个功能,无
系统之家U盘启动盘安装Win10系统图文教程 Windows 10凭借其出色的兼容性和流畅体验,至今仍是用户基数最大的操作系统。当需要重装系统时,使用U盘启动盘进行安装,无疑是高效且可靠的选择。接下来,就为大家详细拆解如何使用系统之家U盘启动盘来完成Win10系统的安装。 准备工作 在开始操作前,你





