Composer如何管理Laravel扩展包_Composer Laravel Package教程【秒懂】

Class not found 错误主因是自动加载未刷新，应优先执行 composer dump-autoload；若包未被发现，再运行 php artisan package:discover 并检查 composer.json 中 autoload 和 extra.lara vel 配置是否合规。

包明明装上了，一用就报 Class not found 或者命令不存在，这事儿是不是挺让人头疼的？其实，问题往往不在于包本身，而是 Lara vel 框架“没认出来”。背后的原因，多半是自动加载没刷新、服务提供者没注册，或者自动发现功能被意外关闭了。

composer require 后类找不到？先跑 dump-autoload

很多人以为，执行完 composer require vendor/package 就万事大吉了。实际上，这条命令只是把包下载到 vendor/ 目录并更新了 composer.json，并不会自动重新生成类的映射关系。Lara vel 在加载新类时，会去查询 vendor/autoload.php 里的那张“地图”，如果地图没更新，自然就找不到路了。

• 所以，第一步永远是立刻运行 composer dump-autoload，强制刷新这张类映射表。
• 接着，检查一下这个包的 composer.json 文件，看看它是否包含了有效的 autoload 配置，比如："psr-4": {"Spatie\Permission\": "src/"}。
• 尤其要注意，如果包使用的是 classmap 或者自定义的加载路径，那么执行 dump-autoload 这一步更是绝对不能跳过。

php artisan package:discover 没输出你的包名？看自动发现开关

从 Lara vel 5.5 开始，框架默认启用了“包自动发现”功能。但这有个前提：包的 composer.json 里不能设置 "dont-discover": ["*"]，并且必须声明了 extra.lara vel 这个配置段。

• 你可以运行 php artisan package:discover 来验证，观察终端输出里是否出现了你的包名（例如 SpatiePermissionPermissionServiceProvider）。
• 如果没出现？那就得去检查该包源码里的 composer.json 了：确认它包含 "extra": {"lara vel": {"dont-discover": false}}（或者干脆没有这一段配置）。
• 万一包被 dont-discover 屏蔽了，那就只能手动将它的服务提供者（providers）添加到 config/app.php 文件里。

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

这里有个常见的误区：在生产环境的部署脚本里写 composer update 其实是个高风险操作。因为它会忽略 composer.lock 文件，重新解析所有依赖的版本，一不小心就可能升级到不兼容的版本，导致线上服务崩溃。

• 记住这个原则：新项目克隆、CI/CD 流水线、线上部署，必须使用 composer install --no-dev。
• 如果只是想升级某个特定的包（比如修复一个安全漏洞），正确的命令是 composer update vendor/package --with-dependencies。
• 另外，composer require 是添加新包的唯一推荐方式；手动修改 composer.json 后再去跑 update，很容易触发全量依赖升级，带来不必要的麻烦。

私有包装不上？权限、autoload、Git 标签三者缺一不可

配置了私有仓库（repositories），却还是提示 Could not find package？别急，问题大概率出在以下三个环节：

• 首先，私有包自己的 composer.json 必须包含完整的 "name": "acme/internal-utils" 和 autoload 配置（例如 "psr-4": {"Acme\InternalUtils\": "src/"}）。
• 其次，Git 仓库必须打上带 v 前缀的语义化版本标签（比如 v1.2.0），否则 Composer 不会将其识别为可安装的版本。
• 最后，如果使用的是 Git SSH 地址，务必确保部署服务器已经配置好对应的 SSH 密钥，并且能够成功执行 git clone。

说到底，最容易被忽略的一点是：包被放进 vendor/ 目录，并不等于它就能被 Lara vel 正常使用。框架的“识别链”——从自动加载（autoload）到包发现（discover），再到服务提供者注册和配置加载——其中任何一环断了，都会导致静默失败。下次再遇到类似问题，先别急着删除整个 vendor 目录重来，不妨盯紧 composer dump-autoload 和 php artisan package:discover 这两条命令的输出信息，往往就能找到突破口。