最快安装Laravel的方式是composer create-project,但需根据版本、环境和需求调整参数;必须满足PHP≥8.2及指定扩展,指定版本用--no-interaction等参数,安装后须复制.env、生成key并设权限。

直接用 composer create-project 装 Laravel 是最快的方式,但默认会拉取最新稳定版(如 11.x),如果你需要特定版本、跳过交互式配置、或在 CI/CD 环境中静默部署,就得调整命令参数和环境准备——否则容易卡在权限、PHP 扩展缺失或国内源失效上。
确认 PHP 环境和必需扩展
Laravel 11 要求 PHP >= 8.2,且必须启用 mbstring、openssl、pdo、tokenizer、xml、ctype、json、zip。缺任意一个,composer create-project 会在解包后执行 php artisan key:generate 阶段报错,错误信息类似:Class 'Mbstring' not found 或 Call to undefined function Illuminate\Support\str_slug()(旧版)。
- 运行
php -v和php -m | grep -E 'mbstring|openssl|pdo|tokenizer|xml|ctype|json|zip'快速核对 - Windows 用户注意:XAMPP/MAMP 自带的 PHP 可能未启用
ext-zip,需手动编辑php.ini解开注释 - Docker 中部署时,基础镜像建议用
php:8.3-cli而非php:8.3-apache,避免 Apache 模块干扰 Composer 运行
用 create-project 指定版本并跳过交互
不加参数直接运行 composer create-project laravel/laravel 会装最新版,且默认触发交互式安装(询问是否安装 Laravel Breeze 等)。生产环境或脚本中应禁用交互、锁定版本、关闭插件自动启用。
- 装 Laravel 10.x(长期支持版):
composer create-project laravel/laravel:^10.0 myapp --no-interaction --no-plugins - 装 Laravel 11.x 并跳过所有提示:
composer create-project laravel/laravel:^11.0 myapp --no-interaction --no-install(--no-install表示暂不执行composer install,方便先改composer.json) - 国内用户务必提前配置镜像源,否则超时失败:
composer config -g repo.packagist composer https://packagist.phpcomposer.com(推荐阿里云源:https://mirrors.aliyun.com/composer/)
安装后必须立即做的三件事
项目目录生成完毕不代表可运行。Laravel 10+ 默认不生成 .env,也不自动设置密钥,php artisan serve 会直接报错 Application key not set。
- 复制环境文件:
cp .env.example .env - 生成应用密钥:
php artisan key:generate(注意:该命令会写入.env的APP_KEY,不可跳过) - 检查存储目录权限(尤其 Linux/macOS):
chmod -R 775 storage bootstrap/cache,否则日志写入失败,php artisan serve启动后访问首页显示空白或 500 错误
最常被忽略的是 APP_URL 和数据库配置——哪怕只跑 php artisan serve,如果后续要调用 URL::to() 或发邮件,.env 里的 APP_URL 必须设为实际访问地址(如 http://localhost:8000),而不是留空或写成 http://127.0.0.1:8000(某些中间件会因 Host 不匹配拒绝请求)。










