isas/php-sdk

ISAS API SDK for PHP

v1.0.3 2026-05-24 14:46 UTC

Requires

• php: >=8.0
• ext-curl: *
• ext-json: *

MIT

• VernonShao

README

欢迎使用 ISAS 官方 PHP SDK。本 SDK 采用现代化设计模式，专为多语言矩阵生态设计，具备高性能、零命名空间污染（零 use 膨胀） 及强类型依赖特征，完美契合 ThinkPHP 8.x、Laravel、Hyperf 等主流框架。

✨ 核心特性

• 🚀 高级动态工厂模式：全局仅需引入一个 Client 入口，所有子服务（豆包AI、UUID 等）链式直达，开发者无需声明臃肿的 use 头部。
• 🔒 安全与密钥隔离：全面移除硬编码，采用构造函数动态注入凭证，支持环境变理配置，防止密钥泄漏。
• ⚡ 按需延迟加载 (Lazy Loading)：符合 PSR-4 规范，未调用的组件绝不加载，百万级扩展亦能保持零内存浪费。
• 🛠 健壮的异常捕获：内置完整的 API 签名计算与统一的错误拦截机制，提供优雅的调试体验。

📂 项目目录规范

请确保您提交到 GitHub 或发布到 Packagist 的代码物理结构对齐如下：

isas-php-sdk/
├── src/                      # 核心源码目录 (PSR-4 映射根路径)
│   ├── Services/             # 开放能力组件目录
│   ├── BaseService.php       # 强类型抽象基类
│   └── Client.php            # SDK 核心总入口客户端 (全自动代理工厂)
├── composer.json             # Composer 包配置文件
├── README.md                 # 接口说明文档
└── demo.php                  # 根目录快速入门示例