Laravel怎么开启自动发现扩展包 _ Laravel Package Discovery配置方法【技巧】

composer install 后扩展包未自动注册，因 laravel 自动发现仅在 install/update 时触发，需满足：包 composer.json 含有效 extra.laravel 配置、项目 laravel ≥5.5；常见原因包括误设 dont-discover、使用 –no-scripts 或本地 path repo 未重扫描。

为什么 composer install 后扩展包没自动注册？

因为 Laravel 的自动发现（Package Discovery）默认只在 composer install 或 composer update 时触发，且依赖两个前提：扩展包的 composer.json 中必须声明 "extra": {"laravel": {"dont-discover": false}}（或不设该字段），同时你的项目 Laravel 版本 ≥ 5.5 —— 低于这个版本压根不支持，强行配也没用。

常见错误现象：php artisan tinker 里调用扩展包提供的 Facade 报错 class not found，或 php artisan list 看不到新增命令，其实不是你漏写了 providers，而是发现机制根本没跑。

• 检查是否误加了 "dont-discover": true 到自己项目的 composer.json 的 extra 区域
• 运行 composer dump-autoload 不会触发发现，必须是 install/update
• 如果用了 Composer 的 --no-scripts 参数，发现脚本会被跳过

discovery 脚本在哪执行？怎么确认它生效了？

Laravel 在 vendor/laravel/framework/src/Illuminate/Foundation/PackageManifest.php 里读取 vendor/composer/installed.json，再扫描每个包的 composer.json 中的 extra.laravel.providers 和 extra.laravel.aliases 字段。它不解析 PHP 代码，只认 JSON 配置。

实操建议：

• 手动触发一次发现：删掉 bootstrap/cache/packages.php，再跑 composer update --lock（哪怕没更新包，也会重生成 manifest）
• 看是否生效：打开 bootstrap/cache/packages.php，搜索你装的包名，如果里面有 'providers' => [...] 就说明被发现了
• 如果包没写 extra.laravel.providers，即使支持 Laravel，也不会被自动注册 —— 这是包作者的责任，不是你的配置问题

想禁用某个包的自动发现，但又不想改它的源码？

可以在你自己项目的 composer.json 里用 extra.laravel.dont-discover 精确排除，值是一个字符串数组，支持通配符 *。

例如：

"extra": {     "laravel": {         "dont-discover": [             "laravel/tinker",             "nunomaduro/collision"         ]     } }

注意点：

• 这个配置只对你自己的项目生效，不影响其他环境
• 写错包名（比如大小写不对、多空格）会导致排除失败，建议从 vendor/composer/installed.json 复制准确名称
• 排除后，若需使用该包，仍要手动在 config/app.php 里补上 providers 和 aliases

自定义包怎么正确声明支持自动发现？

在你写的扩展包的 composer.json 里，必须明确写出 extra.laravel 结构，不能只靠文档说“兼容 Laravel”。

最小可用配置示例：

"extra": {     "laravel": {         "providers": [             "VendorPackageServiceProvider"         ],         "aliases": {             "Helper": "VendorPackageFacadesHelper"         }     } }

关键细节：

• providers 数组里的类必须能被自动加载器找到（即已声明在包的 autoload 里）
• aliases 是可选的；如果写了，对应 Facade 类必须存在且继承 IlluminateSupportFacadesFacade
• 不要在 extra.laravel 里写条件逻辑（比如根据 Laravel 版本切换 provider），Laravel 不解析 PHP 表达式

最常被忽略的一点：本地开发时用 composer path repo 或 repositories.type: path 引入包，composer update 可能不会重新扫描该包的 composer.json —— 此时删掉 bootstrap/cache/packages.php 再试，比反复 dump-autoload 有效得多。