Composer怎么管理Laravel扩展包_Composer Laravel Package教程【精选】-composer-PHP中文网

装包后类找不到或命令报错，根本原因是laravel未识别该包：需执行composer dump-autoload刷新自动加载，检查服务提供者是否注册、自动发现是否启用，并验证私有包的repositories、autoload及git标签配置。

composer怎么管理laravel扩展包_composer laravel package教程【精选】

装包不是执行一条 composer require 就完事——它只是起点，后续不补操作，90% 的“包没生效”问题都出在这一步。

为什么 `composer require` 后类找不到、命令报错？

根本原因不是没装上，而是 Laravel 没“认出”这个包：自动加载没刷新、服务提供者没注册、或自动发现被关了。

运行 composer require spatie/laravel-permission 后，立刻执行 php artisan tinker 并 use SpatiePermissionPermissionServiceProvider 报错？先别怀疑包有问题——vendor/autoload.php 还没更新映射
执行 composer dump-autoload 强制重生成类映射，再试；若仍失败，检查该包的 composer.json 是否含 "autoload": {"psr-4": {"Spatie\Permission\": "src/"}}
新版 Laravel（5.5+）靠 extra.laravel.dont-discover 控制自动注册；如果项目里全局禁用了（比如设成 ["*"]），那所有包都得手动加到 config/app.php 的 providers 数组里
运行 php artisan package:discover，看输出里有没有你的包名；没出现，说明自动发现流程压根没走到它

`composer install` 和 `composer update` 到底该用哪个？

在 Laravel 项目里混用这两个命令，是线上环境突然崩掉的最常见原因。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

composer install：只读 composer.lock，装里面锁死的版本，保证所有环境（本地、CI、生产）依赖完全一致 —— 部署脚本、Git 克隆后第一句必须是它
composer update：无视 lock，重新解析 composer.json 里的约束（比如 "^10.0"），可能装上带 BC break 的新小版本（如 guzzlehttp/guzzle v7.8.0 → v7.9.0 里某个方法签名变了）
想升级单个包？用 composer update vendor/package --with-dependencies，比裸 update 安全得多
CI/CD 流水线里永远加 --no-dev：composer install --no-dev，否则 phpunit 或 larastan 会进生产环境，还可能因扩展缺失直接报错

私有包怎么让 Laravel 正确加载？

不是加个 repositories 就能用——权限、autoload、Git 标签三者缺一不可。

私有包仓库地址必须写进项目 composer.json 的 repositories 字段，类型为 vcs，URL 推荐用 SSH（如 git@gitlab.com:acme/internal-utils.git），避免 HTTPS 下 Token 过期或交互式认证卡住
私有包自己的 composer.json 必须声明 "name": "acme/internal-utils" 和完整 autoload，例如："autoload": {"psr-4": {"Acme\InternalUtils\": "src/"}}
Laravel 不会自动发现私有包（除非你显式在 extra.laravel.dont-discover 里排除它），所以大概率要手动在 config/app.php 加 AcmeInternalUtilsInternalUtilsServiceProvider::class
发布新版本？别只改 composer.json 里的 version 字段——必须打 Git tag（如 v2.1.3），然后项目里跑 composer update acme/internal-utils 才能拉到

真正卡住人的，从来不是“怎么装”，而是“装完之后 Laravel 看不见它”——autoload 没刷、provider 没注册、discover 被禁、PHP 版本不匹配，这些点藏得深，但每个都有明确验证路径。别猜，一个个 dump-autoload、package:discover、show、why 查过去，比重装十遍都快。