PHPackages                             qingze-lab/esignbao-sdk-php - 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. [HTTP & Networking](/categories/http)
4. /
5. qingze-lab/esignbao-sdk-php

ActiveLibrary[HTTP & Networking](/categories/http)

qingze-lab/esignbao-sdk-php
===========================

易签宝 REST API PHP SDK，支持实名认证V3和PDF合同签署，包含令牌管理、可重试HTTP和领域服务。

v0.1.12(4mo ago)024MITPHPPHP >=8.2

Since Dec 19Pushed 4mo agoCompare

[ Source](https://github.com/qingze-lab/esign-sdk-php)[ Packagist](https://packagist.org/packages/qingze-lab/esignbao-sdk-php)[ Docs](https://github.com/qingze-lab/esign-sdk-php)[ RSS](/packages/qingze-lab-esignbao-sdk-php/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (4)Versions (13)Used By (0)

易签宝 PHP SDK
===========

[](#易签宝-php-sdk)

易签宝（e签宝）开放平台 V3 API 的非官方 PHP SDK。

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)

> **注意**: 本 SDK 基于易签宝 V3 版本 API 开发，支持 PHP 8.2+。

✨ 特性
----

[](#-特性)

- **完整覆盖**: 支持实名认证、文件管理、合同模板、签署流程等核心业务。
- **强类型**: 充分利用 PHP 8.2 类型系统，代码更加健壮。
- **易于使用**: 采用领域服务模式设计，调用逻辑清晰直观。
- **自动签名**: 内置 API 请求签名逻辑，开发者无需关心鉴权细节。
- **重试机制**: 内置 HTTP 请求自动重试机制，提高网络波动下的稳定性。

📦 安装
----

[](#-安装)

使用 Composer 安装：

```
composer require qingze-lab/esignbao-sdk-php
```

🚀 快速开始
------

[](#-快速开始)

### 1. 初始化客户端

[](#1-初始化客户端)

```
use QingzeLab\ESignBao\Client;
use QingzeLab\ESignBao\Config\Configuration;

$config = new Configuration(
    appId: 'your_app_id',
    appSecret: 'your_app_secret',
    apiBaseUrl: 'https://smlopenapi.esign.cn' // 沙箱环境
);

$client = new Client($config);
```

### 2. 发起一份签署流程

[](#2-发起一份签署流程)

```
// 1. 上传文件
$uploadResult = $client->file()->uploadFileByPath('./contract.pdf');
$fileId = $uploadResult['data']['fileId'];

// 2. 创建签署流程
$flowResult = $client->signFlow()->createByFile(
    docs: [
        ['fileId' => $fileId, 'fileName' => '合同.pdf']
    ],
    signFlowConfig: [
        'signFlowTitle' => '测试合同签署',
        'autoStart' => true,
        'autoFinish' => true
    ],
    signers: [
        [
            'signerType' => 0, // 个人签署
            'psnSignerInfo' => ['psnAccount' => '188****8888'],
            'signFields' => [
                ['fileId' => $fileId, 'posPage' => '1', 'posX' => 100, 'posY' => 100]
            ]
        ]
    ]
);
$signFlowId = $flowResult['data']['signFlowId'];

// 3. 获取签署链接
$signUrl = $client->signFlow()->getSignUrl(
    signFlowId: $signFlowId,
    operator: ['psnAccount' => '188****8888']
);

echo "签署链接: " . $signUrl['data']['shortUrl'];
```

📖 文档
----

[](#-文档)

详细的接口说明和使用文档请查阅 [Wiki](.wiki.md)。

- [认证服务 (AuthService)](.wiki.md#%E8%AE%A4%E8%AF%81%E6%9C%8D%E5%8A%A1-authservice)
- [文件服务 (FileService)](.wiki.md#%E6%96%87%E4%BB%B6%E6%9C%8D%E5%8A%A1-fileservice)
- [模板服务 (TemplateService)](.wiki.md#%E6%A8%A1%E6%9D%BF%E6%9C%8D%E5%8A%A1-templateservice)
- [签署流程服务 (SignFlowService)](.wiki.md#%E7%AD%BE%E7%BD%B2%E6%B5%81%E7%A8%8B%E6%9C%8D%E5%8A%A1-signflowservice)

🤝 贡献
----

[](#-贡献)

欢迎提交 Issue 或 Pull Request 来改进本项目。

📄 许可证
-----

[](#-许可证)

本项目基于 MIT 许可证开源。详情请参阅 [LICENSE](LICENSE) 文件。

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance74

Regular maintenance activity

Popularity9

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

12

Last Release

145d ago

PHP version history (2 changes)v0.1.0PHP ^8.2

v0.1.1PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/e7b237ece7b85bc0d10e934879e4c5f6c28e65052cfd0d697af82d27b9c5cd11?d=identicon)[luck-ming](/maintainers/luck-ming)

---

Tags

phpsdkrestAuthenticationcontracte-signatureesignbao

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/qingze-lab-esignbao-sdk-php/health.svg)

```
[![Health](https://phpackages.com/badges/qingze-lab-esignbao-sdk-php/health.svg)](https://phpackages.com/packages/qingze-lab-esignbao-sdk-php)
```

###  Alternatives

[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[xeroapi/xero-php-oauth2

Xero official PHP SDK for oAuth2 generated with OpenAPI spec 3

1054.7M18](/packages/xeroapi-xero-php-oauth2)[onesignal/onesignal-php-api

A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com

34216.9k2](/packages/onesignal-onesignal-php-api)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)