直接用 composer create-project 安装 Laravel 即可,但需确保 PHP ≥ 8.2 并启用 mbstring、openssl、pdo、tokenizer、xml、ctype、json 扩展;国内用户必须配置阿里云或腾讯 Composer 镜像源;安装后须执行 php artisan key:generate 和 php artisan serve 才能正常访问。

直接用 composer create-project 就能装好 Laravel,不需要先手动建目录或改配置。但很多人卡在权限、PHP 版本、扩展缺失或国内源没切对这几个点上。
确认 PHP 环境和必要扩展
Laravel 11 要求 PHP ≥ 8.2,且必须启用 mbstring、openssl、pdo、tokenizer、xml、ctype、json 这些扩展。缺一个都会报错,比如:
RuntimeException: The use statement with aliasing is not allowed here
这类错误往往不是语法问题,而是 tokenizer 没开。检查方式:
- 运行
php -v看版本 - 运行
php -m | grep -E 'mbstring|openssl|pdo|tokenizer'确认模块已加载 - Windows 用户注意:XAMPP/MAMP 自带的 PHP 可能没开全扩展,得去
php.ini里取消对应行的分号注释
用 create-project 安装指定版本的 Laravel
别用 composer global require laravel/installer,那个工具早已过时,且容易和全局 Composer 配置冲突。直接跑:
立即学习“PHP免费学习笔记(深入)”;
composer create-project laravel/laravel myproject "11.*"
说明:
-
myproject是项目目录名,会自动创建 -
"11.*"是版本约束,加引号防 shell 解析错误;想装 Laravel 10 就写"10.*" - 如果卡在
Installing dependencies超过 2 分钟,大概率是没切国内镜像源
国内用户必须设置阿里云或腾讯 Composer 镜像
默认走 packagist.org,国内直连极慢甚至超时,表现为反复重试或最终报 Connection timed out。执行以下任一命令切换:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
或
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
验证是否生效:
- 运行
composer config -g repo.packagist,输出应为镜像地址 - 新项目安装速度会从几分钟降到 30 秒内
- 如果之前装失败过,删掉生成一半的
myproject目录再重试
安装完必须立刻做三件事
刚跑完 create-project 不代表就能访问。常见“白屏”或 Whoops, looks like something went wrong 都是因为没走这步:
- 进项目目录:
cd myproject - 生成应用密钥:
php artisan key:generate(否则 session 和加密全崩) - 启动内置服务器:
php artisan serve(默认http://127.0.0.1:8000) - 别用浏览器直接打开
public/index.php—— 这样绕过 autoloader,必然报错
环境变量、数据库配置这些可以后面配,但 key:generate 是启动前硬性门槛,漏了就看不到欢迎页。











