判断标准是是否跨项目复用、是否需独立版本控制、是否要被他人安装使用；例如微信支付封装类放app/更轻量，短信网关SDK则必须抽成独立包。
怎么判断该做成独立包还是直接写在 app/ 里
不是所有可复用的代码都值得发成 Composer 包。核心判断标准是：是否跨项目复用、是否需独立版本控制、是否要被他人安装使用。比如一个只在当前项目里用的「微信支付封装类」，放在 app/Services/WechatPay.php 更轻量；但如果你要给多个 Laravel 项目（甚至非 Laravel 项目）提供统一的「短信网关 SDK」，那就必须抽成独立包。
容易踩的坑：
• 过早抽象：功能还没稳定就发包，后续改接口会破坏下游依赖
• 忽略 Laravel 版本约束：用到了 IlluminateSupportArr::wrap() 却声明支持 Laravel 8+，而该方法在 9.0+ 才加入 —— 实际运行时会报 Call to undefined method
• 把配置硬编码进包里，没留 config/ 发布入口，导致用户无法自定义
创建包结构并注册 Service Provider
Laravel 包本质是一个带 ServiceProvider 的 PHP 库。推荐用 composer create-project laravel/laravel-package-skeleton 起手，或手动建目录：
mycompany/laravel-sms ├── src/ │ ├── SmsServiceProvider.php │ ├── Facades/Sms.php │ └── SmsClient.php ├── config/sms.php ├── resources/lang/en/sms.php └── composer.json
关键点：
• SmsServiceProvider 必须继承 IlluminateSupportServiceProvider，并在 register() 中绑定服务，在 boot() 中发布配置/迁移/语言包
• 若想支持 Sms::send() 静态调用，需定义 Facades/Sms 并指向具体类
• 在 composer.json 的 autoload 里声明 PSR-4 自动加载路径："MyCompany\Sms\": "src/"
如何让包支持 Laravel 自动发现（Auto-Discovery）
Laravel 5.5+ 默认启用自动发现，但前提是你的包在 composer.json 的 extra.laravel.dont-discover 里没被禁用，且正确声明了 extra.laravel.providers：
{
"extra": {
"laravel": {
"providers": [
"MyCompany\Sms\SmsServiceProvider"
]
}
}
}
如果用户装了你的包却没生效，先检查：
• 是否清空了 bootstrap/cache/packages.php（Laravel 会缓存自动发现结果）
• composer dump-autoload 是否执行成功
• php artisan package:discover --ansi 是否输出了你的包名 —— 没输出说明 extra.laravel.providers 格式错或路径不对
发布到 Packagist 并设置版本号
发布前确保：
• GitHub 仓库设为 public，且有清晰的 README.md 和 license
• composer.json 中 name 字段格式为 vendor/name（如 mycompany/laravel-sms），且与 Packagist 上注册的 vendor 名一致
• 使用语义化版本（1.0.0、1.0.1、1.1.0），重大变更必须升主版本号
流程：
• 登录 Packagist，点击 “Submit Package”，填入 GitHub 仓库地址
• 首次提交后，Packagist 会自动监听 GitHub 的 tag 推送 —— 之后只需 git tag v1.0.0 && git push --tags，新版本就会同步
• 用户安装时运行 composer require mycompany/laravel-sms，Composer 会自动拉取最新稳定版
注意：别用 dev-master 当正式版。Laravel 的 minimum-stability 默认是 stable，不加 @dev 后缀根本装不上开发分支。
