composer怎么安装常用扩展包_composer怎么快速集成功能【实操】

composer require 是安装 PHP 扩展包的首选命令，因其仅写入 composer.json、下载包至 vendor/、更新 composer.lock，不触发全局依赖重解析，避免误升版本引发线上问题。

为什么 composer require 是首选？

它只做三件事：写入 composer.json、下载包到 vendor/、更新 composer.lock。不碰其他已锁版本，不触发全局依赖重解析。
而 composer update 会重新计算整个依赖树，哪怕你只加一个包，也可能把 monolog/monolog 从 2.9.1 升到 2.10.0，而这个小版本可能悄悄改了日志上下文格式。

• 新包必须运行在项目根目录下：执行 ls -la | grep composer.json（Linux/macOS）或 dir composer.json（Windows）确认当前路径对
• 如果提示 Package not found，先检查包名是否完整，比如 maatwebsite/excel 少写 maatwebsite/ 就找不到
• 加 -v 参数可看真实失败原因：composer require laravel/sanctum -v，比静默失败更早暴露 PHP 版本或 Laravel 主版本不匹配

composer require 装不上？先查这三件事

不是包有问题，大概率是环境卡点没过。常见现象如：Could not parse version constraint、requirement not met、或命令执行完但 vendor/ 里没文件。

• PHP 和 Laravel 版本是否对得上？例如 maatwebsite/excel:^3.4 要求 PHP ≥ 8.0 且 Laravel 10，Laravel 9 项目硬装会失败
• 国内网络直连 packagist.org 基本超时，必须切镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，换完立刻 composer clear-cache
• 某些包（如老版 barryvdh/laravel-debugbar）不支持自动发现，require 成功后仍要手动加 Barryvdh\Debugbar\ServiceProvider::class 到 config/app.php

装完为啥类找不到？autoload 没刷、provider 没配、facade 没挂

composer require 不等于“开箱即用”。很多包需要额外一步才能被代码识别，典型错误是 Class 'Excel' not found 或 Facade does not exist。

AITDK

免费AI SEO工具，SEO的AI生成器

下载

• 先跑 composer dump-autoload，尤其当你加了自定义命名空间或本地开发包时，否则 vendor/autoload.php 不知道新类在哪
• Laravel 8 及更早版本需手动注册服务提供者和门面；Laravel 9+ 默认启用 auto-discovery，但如果你在 composer.json 里写了 "dont-discover": ["*"]，那所有包都得手配
• 配置文件没发布：比如 Excel 要运行 php artisan vendor:publish --provider="Maatwebsite\Excel\ExcelServiceProvider" 才生成 config/excel.php，否则用默认值可能连 Excel 导出都报错

扩展包要不要加 --dev？看它进不进生产流程

加错位置，上线就炸。判断标准非常直接：你的业务代码里有没有 use 它、调用它的类或函数。

• 运行时依赖（如 guzzlehttp/guzzle、spatie/laravel-permission）必须无 --dev 安装，否则 composer install --no-dev 会删掉它，导致 Class not found
• --dev 只给纯开发工具：比如 phpunit/phpunit、larastan/larastan、barryvdh/laravel-ide-helper
• 有些包文档写“for Laravel”，但实际要求 Laravel 10+，而你项目是 9.x——require 成功不代表能用，得去它 composer.json 里查 "require": {"laravel/framework": "^10.0"}