Composer安装Laravel框架教程_使用Composer快速部署项目【实战】

4次阅读

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

Composer安装Laravel框架教程_使用Composer快速部署项目【实战】

直接用 composer create-project 装 Laravel 是最快的方式,但默认会拉取最新稳定版(如 11.x),如果你需要特定版本、跳过交互式配置、或在 CI/CD 环境中静默部署,就得调整命令参数和环境准备——否则容易卡在权限、PHP 扩展缺失或国内源失效上。

确认 PHP 环境和必需扩展

Laravel 11 要求 PHP >= 8.2,且必须启用 mbstringopensslpdotokenizerxmlctypejsonzip。缺任意一个,composer create-project 会在解包后执行 php artisan key:generate 阶段报错,错误信息类似:class 'Mbstring' not foundCall to undefined function IlluminateSupportstr_slug()(旧版)。

  • 运行 php -vphp -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(注意:该命令会写入 .envAPP_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 不匹配拒绝请求)。

text=ZqhQzanResources