PHPackages                             isas/php-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. isas/php-sdk

ActiveLibrary[API Development](/categories/api)

isas/php-sdk
============

ISAS API SDK for PHP

v1.0.3(1w ago)032↑743.8%MITPHPPHP &gt;=7.4

Since May 28Pushed 1w agoCompare

[ Source](https://github.com/ISAS-DATA/isas-php-sdk)[ Packagist](https://packagist.org/packages/isas/php-sdk)[ RSS](/packages/isas-php-sdk/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependenciesVersions (5)Used By (0)

ISAS Official SDK for PHP
=========================

[](#isas-official-sdk-for-php)

[![Latest Stable Version](https://camo.githubusercontent.com/b44111a7ed241fc94805144cef42ba3db55f8aa0e8ce013b8808b4150a6f674f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f697361732f7068702d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/isas/php-sdk)[![Total Downloads](https://camo.githubusercontent.com/9a72b80f8396b1a18cd34ae1e85e4f80b281990f5aab96e7751f3ed31026c5a8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f697361732f7068702d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/isas/php-sdk)[![License](https://camo.githubusercontent.com/4d3855bd36032178de0753e3e87e09d08ffd8aff5b0b259f78abb41af52d0229/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f697361732f7068702d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/isas/php-sdk)[![PHP Version Require](https://camo.githubusercontent.com/b279d88246a0a98386163cea42db0a4b29ed1c040cb06042621b1e2978eb0b60/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f697361732f7068702d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/isas/php-sdk)

欢迎使用 ISAS起零数据（）官方 PHP SDK。本 SDK 采用现代化设计模式，专为多语言矩阵生态设计，具备高性能、**零命名空间污染** 及强类型依赖特征，适用于： Laravel / ThinkPHP 6.x 8.x / Hyperf / Symfony / Yii2 / Slim / CodeIgniter4 等主流 PHP 框架及原生 PHP 项目。

---

✨ 核心特性
------

[](#-核心特性)

- **🚀 高级动态工厂模式**：全局仅需引入一个“Client”入口，所有子服务链式直达，开发者无需声明臃肿的use头部，让代码更简洁清爽。同时我们也保留了独立服务实例调用的方式，满足不同的开发习惯。
- **🔒 安全与密钥隔离**：全面移除硬编码风险，采用构造函数动态注入凭证，完美支持环境变量配置，让您的 API 密钥安全可控，从源头避免密钥泄漏的安全隐患。
- **⚡ 按需延迟加载 (Lazy Loading)**：完全符合 PSR-4 规范，未调用的组件绝不加载，即使面对平台海量的扩展能力，也能保持零内存浪费，完全不会影响您原有项目的性能表现。
- **🛠 健壮的异常捕获**：内置完整的错误拦截机制，统一处理网络异常、参数错误、服务调用异常等各类问题，提供优雅的调试体验，帮您快速定位问题，减少排错时间。
- **🛡️ 内置动态签名算法**：SDK原生封装了平台标准化的动态签名逻辑，开发者无需手动编写复杂的签名校验与加密计算代码，开箱即用，彻底告别对接时的签名调试痛点，大幅降低对接成本。

---

📂 项目目录规范
--------

[](#-项目目录规范)

```
isas-php-sdk/
├── src/                      # 核心源码目录 (符合 PSR-4 自动加载标准)
│   ├── Exception/            # SDK 异常处理体系目录
│   │   ├── IsasException.php     # SDK 基础异常类 (全局总异常拦截门面)
│   │   ├── NetworkException.php  # 网络层传输异常类 (cURL超时、DNS故障等)
│   │   └── ServiceException.php  # 应用层业务异常类 (HTTP状态码非200、接口报错)
│   ├── Services/             # 开放能力原子组件目录
│   │   ├── Ai.php                # AI/人工智能相关服务能力组件
│   │   ├── Develop.php           # 研发辅助类相关服务能力组件
│   │   ├── Health.php            # 健康管理相关服务能力组件
│   │   ├── HotRank.php           # 热点/热搜榜相关服务能力组件
│   │   ├── News.php              # 新闻类相关服务能力组件
│   │   ├── Tools.php             # 综合工具相关服务能力组件
│   │   └── Web.php               # 网站相关服务能力组件
│   ├── BaseService.php       # 组件抽象抽象基类 (声明基础构造与生命周期)
│   └── Client.php            # SDK 核心入口客户端 (实现多组件全自动代理路由)
├── .gitignore                # Git 版本控制忽略配置文件
├── LICENSE                   # 开源授权协议文件 (MIT License)
├── README.md                 # SDK 技术框架与接口说明文档
├── composer.json             # Composer 依赖包与自动加载配置文件
└── demo.php                  # 根目录快速入门与异常调试示例

---

```

📦 完整源码清单 (Source Code)
----------------------

[](#-完整源码清单-source-code)

### 1. `composer.json` (包配置文件)

[](#1-composerjson-包配置文件)

```
{
    "name": "isas/php-sdk",
    "description": "ISAS API SDK for PHP",
    "type": "library",
    "license": "MIT",
    "require": {
        "php": ">=8.0",
        "ext-curl": "*",
        "ext-json": "*"
    },
    "autoload": {
        "psr-4": {
            "Isas\\Sdk\\": "src/"
        }
    }
}
```

### 2. `src/Client.php` (核心总入口)

[](#2-srcclientphp-核心总入口)

```
