包简介

Official PHP SDK for UAPI / uapis.cn — typed PHP 8.1+ wrapper around 100+ free public-API endpoints (network, text, image, social, translation, search). Generated from the live OpenAPI 3.1 spec.

README 文档

README

Note

所有接口的 PHP 示例都可以在 UApi 的接口文档页面，向下滚动至 快速启动 区块后直接复制。

快速开始

composer require AxT-Team/uapi-sdk-php

<?php
require 'vendor/autoload.php';

$client = new Uapi\Client('https://uapis.cn', 'YOUR_API_KEY');
$result = $client->social()->getSocialQqUserinfo(['qq' => '10001']);
var_dump($result);

特性

现在你不再需要反反复复的查阅文档了。

只需在 IDE 中键入 $client->，所有核心模块——如 social()、game()、image()——即刻同步展现。进一步输入即可直接定位到 getSocialQqUserinfo 这样的具体方法，其名称与文档的 operationId 严格保持一致，确保了开发过程的直观与高效。

所有方法签名只接受真实且必需的参数。当你在构建请求时，IDE 会即时提示 qq、username 等键名，这彻底杜绝了在关联数组中因键名拼写错误而导致的运行时错误。

针对 401、404、429 等标准 HTTP 响应，SDK 已将其统一映射为具名的异常类型。这些异常均附带 code、status、details 等关键上下文信息，确保你在日志中能第一时间准确、快速地诊断问题。

HTTP 层基于 Guzzle，构造函数会自动设置 Base URL、追加 Authorization 头并关闭 http_errors，方便你直接读取 JSON/字节响应；需要更细致的超时或代理策略时，可以按需扩展这段初始化逻辑。

如果你需要查看字段细节或内部逻辑，仓库中的 ./internal 目录同步保留了由 openapi-generator 生成的完整结构体，随时可供参考。

错误模型概览

HTTP 状态码	SDK 错误类型	附加信息
401/403	`UnauthorizedError`	`code`、`status`
404	`NotFoundError` / `NoMatchError`	`code`、`status`
400	`InvalidParameterError` / `InvalidParamsError`	`code`、`status`、`details`
429	`ServiceBusyError`	`code`、`status`、`retry_after_seconds`
5xx	`InternalServerErrorError` / `ApiErrorError`	`code`、`status`、`details`
其他 4xx	`UapiError`	`code`、`status`、`details`

其他 SDK

语言	仓库地址
Go	https://github.com/AxT-Team/uapi-sdk-go
Python	https://github.com/AxT-Team/uapi-sdk-python
TypeScript	https://github.com/AxT-Team/uapi-sdk-typescript
Browser (TypeScript/JavaScript)	https://github.com/AxT-Team/uapi-browser-sdk
Java	https://github.com/AxT-Team/uapi-sdk-java
PHP（当前）	https://github.com/AxT-Team/uapi-sdk-php
C#	https://github.com/AxT-Team/uapi-sdk-csharp
C++	https://github.com/AxT-Team/uapi-sdk-cpp
Rust	https://github.com/AxT-Team/uapi-sdk-rust

文档

访问 UApi文档首页并选择任意接口，向下滚动到 快速启动 区块即可看到最新的 PHP 示例代码。

axt-team/uapi-sdk-php 适用场景与选型建议

axt-team/uapi-sdk-php 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 36 次下载、GitHub Stars 达 0，最近一次更新时间为 2025 年 11 月 11 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「php」「http」「rest」「client」「sdk」「Agent」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 axt-team/uapi-sdk-php 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 axt-team/uapi-sdk-php 我们能提供哪些服务？

定制开发 / 二次开发

基于 axt-team/uapi-sdk-php 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发