php-saloon
php-saloon 是一个用于构建和调试 PHP API 集成与 SDK 的技能,基于 Saloon 库。它覆盖连接器、请求、认证、请求体、测试、分页、Laravel 集成以及插件工作流等场景。该技能强调强类型设计:响应使用强类型 DTO,推荐用 github.com/Crell/Serde 做序列化;参数较多或 DTO 能明显改善开发体验时使用类型化 DTO;需要泛型处补充 docblock。它还要求为支持认证的 API 添加认证、支持分页、添加限流、以可选依赖方式支持缓存并允许开发者传入自己的缓存实现、允许注册自定义中间件,并添加自定义异常(含基础 SDK 异常与常见失败的具体异常),异常中携带请求与响应以便排查。测试方面要求不访问真实 API。Laravel 支持保持可选并隔离在独立命名空间,以可选依赖形式加入 Laravel 插件,实现 facade 与配置,通过包装类自动装配 SDK 并应用认证、缓存、中间件组合等可选关注点,使用 spatie/laravel-package-tools 进行包装配。