跳转到主内容
极星编程网:以代码为星,赴技术山海!

Composer怎么安装Laravel框架_最新版Laravel环境一键搭建【全攻略】

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

相关文章