Laravel扩展包核心判断标准是是否跨项目复用、是否需独立版本控制、是否要被他人安装使用；例如短信类仅当前项目用则放app/，双通道SDK需发独立包。
直接上结论：Laravel 扩展包不是“功能封装完就能发”，核心在于「是否跨项目复用」和「是否需要独立版本控制」。一个只在当前项目里用的短信发送类，放 app/Services/SmsClient.php 更干净；但如果你要给 5 个不同 Laravel 项目统一接入阿里云+腾讯云双通道，就必须做成独立包。
怎么判断该做成包还是写在 app/ 里
别被“可复用”三个字带偏——很多代码看似能复用，实际只是复制粘贴几次而已。真正值得抽成包的信号很具体：
- 你已经在至少两个不同 Laravel 项目中复制了同一段逻辑（比如 JWT 登录校验、Excel 导出模板）
- 你需要为这个功能单独打 tag、发 release、写 changelog，并让别人
composer require yourname/laravel-xxx - 它依赖了特定 Laravel 版本特性（比如
IlluminateSupportArr::wrap()只在 9.0+ 存在），而你必须明确声明兼容范围 - 你要提供配置文件、迁移、视图、语言包等 Laravel 特有资源，且希望用户执行
php artisan vendor:publish一键导出
容易踩的坑是过早抽象：刚写完一个 SmsManager 就急着发包，结果两周后发现驱动接口要从 send($to, $msg) 改成 send(array $payload)，所有下游项目全挂。
服务提供者里 register() 和 boot() 怎么分工
register() 只做绑定，boot() 只做加载。这是 Laravel 容器生命周期决定的，错位会导致配置未合并就尝试读取、视图路径未注册就渲染失败。
-
register()中只能：$this->app->singleton('sms', SmsClient::class)、$this->app->bind(...)、$this->app->when(...)->needs(...)->give(...) -
boot()中才能：$this->mergeConfigFrom(...)、$this->publishes([...], 'config')、$this->loadViewsFrom(...)、Blade::directive(...) - 常见错误：
boot()里调用$this->app['sms']->send()—— 此时容器可能还没完成绑定，报Target class [sms] does not exist
如何让包支持 Laravel 自动发现（Auto-Discovery）
自动发现不是默认开启的魔法，它依赖你在 composer.json 的 extra.laravel.providers 字段里精确声明服务提供者类名。
- 必须写全限定类名：
"YourName\SmsNotification\SmsNotificationServiceProvider"，不能漏掉命名空间或大小写错误 - 确保
autoload.psr-4已映射到src/，否则 Composer 找不到这个类，Laravel 就跳过注册 - 如果主项目禁用了发现（
extra.laravel.dont-discover包含你的包名），自动发现完全不生效，此时必须手动加到config/app.php的providers数组 - 测试是否生效：安装包后运行
php artisan package:discover，看输出里有没有你的包名；或者检查bootstrap/cache/packages.php是否已写入
本地开发时怎么快速测试包改动
别每次改一行就 composer update，那是在浪费时间。本地开发最稳的方式是 path repository + 符号链接。
- 在主项目的
composer.json的repositories下加一条：{"type": "path", "url": "./packages/yourname/sms-notification"} - 然后
composer require yourname/sms-notification:@dev，Composer 会软链过去，改包里代码立刻生效 - 注意：改完
composer.json后要删掉vendor/yourname/sms-notification和composer.lock，再composer install，否则旧缓存还在 - 如果要用 PHPUnit 测试包本身，别在主项目跑
phpunit—— 应该进packages/yourname/sms-notification目录，用OrchestralTestbench搭建隔离测试环境
最常被忽略的是版本约束：你在包的 composer.json 里写了 "illuminate/support": "^10.0"，但主项目是 Laravel 9.x，composer require 会直接失败，而不是降级适配。要么放宽约束，要么在 require-dev 里用 testbench 显式指定测试用的 Laravel 版本。
