最干净可靠的 Laravel 安装方式是直接使用 composer create-project laravel/laravel myapp "11.*",无需全局安装 laravel/installer;需确保 PHP ≥ 8.2 并启用 mbstring、openssl、pdo、tokenizer、xml、ctype、json 七个扩展;国内用户务必配置阿里云镜像源;安装后必须执行 cp .env.example .env 和 php artisan key:generate 才能正常启动。
直接用
,别碰
现在装 Laravel 最干净、最可靠的方式就是一条命令搞定,不需要提前装全局安装器。那个
不仅早已过时,还容易和你本地的 Composer 全局配置冲突,导致版本错乱或命令不响应。
正确做法:
(Laravel 11 要求 PHP ≥ 8.2)
想装 Laravel 10?把版本号换成
;要精确到小版本,比如
也完全支持
必须加英文引号,否则 shell 会把
当前目录文件名展开,报错
不用手动建目录、不用改
,项目结构、依赖、自动加载全由 Composer 一步拉齐
PHP 版本和扩展缺一不可,报错不是代码问题而是环境没配好
很多人看到
就去查语法,其实根本不是 PHP 代码写错了——是
扩展没开。Laravel 11 强制要求 PHP ≥ 8.2,并启用
、
、
、
、
、
、
这七个扩展,少一个就卡在 autoload 或启动阶段。
检查 PHP 版本:
检查扩展是否加载:
Windows 用户注意:XAMPP/MAMP 自带的
默认注释掉了很多扩展,得手动删掉前面的分号,改完必须重启服务
Linux/macOS 用户如果用
或
装的 PHP,可能需要额外执行
类似命令
国内用户不切镜像源,90% 概率卡死在
Composer 默认走海外
,国内直连大概率超时或反复重试,表现就是卡在
超过 2 分钟,最后报
或干脆中断。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化,改进了依赖解析算法,提升大型项目中的安装与更新速度。它支持并行下载任务,显著减少等待时间,并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷,确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护,Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
必须执行一次全局镜像切换:
验证是否生效:
,输出应为阿里云或腾讯云地址
如果之前失败过,先删掉半成品目录(如
),再重跑
,否则 Composer 可能复用损坏的缓存
切完镜像后,完整安装通常能在 30 秒内完成,快慢立判
装完不能直接访问,三件事漏一不可
跑完
只是把代码拉下来,不代表能跑起来。白屏、“Whoops” 错误、500 页面,八成是因为跳过了这三步。
进项目目录:
复制环境文件:
生成密钥:
(这步必须做,否则 session、cookie 加密失败,页面直接崩)
做完以上才能跑
,访问
看欢迎页
storage 和 bootstrap/cache 目录权限问题常被忽略,尤其在 WSL 或 Docker 环境里,如果后续报“failed to open stream: Permission denied”,就得手动补一句
。
composer create-projectlaravel/installerlaravel/installercomposer create-project laravel/laravel myapp "11.*""10.*""9.52.16""10.*"*Could not find package laravel/laravel with version 10.composer.jsonRuntimeException: The use statement with aliasing is not allowed heretokenizermbstringopensslpdotokenizerxmlctypejsonphp -vphp -m | grep -E 'mbstring|openssl|pdo|tokenizer|xml|ctype|json'php.iniaptbrewsudo phpenmod mbstring openssl tokenizerInstalling dependenciespackagist.orgInstalling dependenciesConnection timed outcomposer config -g repo.packagist composer https://mirrors.aliyun.com/composer/composer config -g repo.packagistmyappcreate-projectcomposer create-projectcd myappcp .env.example .envphp artisan key:generatephp artisan servehttp://127.0.0.1:8000chmod -R 755 storage bootstrap/cache