PHPackages                             kylin987/zzb-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. [API Development](/categories/api)
4. /
5. kylin987/zzb-sdk-php

ActiveLibrary[API Development](/categories/api)

kylin987/zzb-sdk-php
====================

PHP SDK for ZZB cinema, screen, film query APIs and ticket reporting

v2.0.4(1mo ago)022↓81%MITPHPPHP >=8.1

Since Mar 23Pushed 1mo agoCompare

[ Source](https://github.com/kylin987/zzb-sdk-php)[ Packagist](https://packagist.org/packages/kylin987/zzb-sdk-php)[ Docs](https://github.com/kylin987/zzb-sdk-php)[ RSS](/packages/kylin987-zzb-sdk-php/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (3)Versions (9)Used By (0)

zzb-sdk-php
===========

[](#zzb-sdk-php)

> **已弃用** — 本包已拆分为两个独立包，不再维护新功能。

迁移说明
----

[](#迁移说明)

本包原有的双模式（legacy + netsale2025）已按业务职责拆分为两个独立 SDK：

旧包新包用途`kylin987/zzb-sdk-php` (legacy 模式)**[`kylin987/zzb-ticket-sdk`](https://github.com/kylin987/zzb-ticket-sdk)**购票交易：影院 / 影厅 / 场次 / 座位查询、锁座、下单、退票`kylin987/zzb-sdk-php` (netsale2025 模式)**[`kylin987/netsale-report-sdk`](https://github.com/kylin987/netsale-report-sdk)**票房上报：售票 / 退票上报、数据比对文件下载### 为什么拆分

[](#为什么拆分)

1. **业务无重合**：legacy 模式用于购票流程（查询 / 交易），netsale2025 模式用于正式票房上报，两者签名方式、证书格式、接口地址完全不同。
2. **依赖清晰**：只需上报能力的项目不必引入查询 / 交易代码和 PFX 证书解析逻辑。
3. **独立演进**：两个协议各自迭代，互不影响。

### 迁移步骤

[](#迁移步骤)

#### 1. 替换依赖

[](#1-替换依赖)

```
# 移除旧包
composer remove kylin987/zzb-sdk-php

# 按需安装新包
composer require kylin987/zzb-ticket-sdk      # 购票/查询/交易
composer require kylin987/netsale-report-sdk   # 票房上报
```

#### 2. 命名空间替换

[](#2-命名空间替换)

旧命名空间新命名空间所属包`ZzbSdk\ZzbService``ZzbTicketSdk\ZzbTicketService`zzb-ticket-sdk`ZzbSdk\Config``ZzbTicketSdk\Config`zzb-ticket-sdk`ZzbSdk\Exception\ZzbException``ZzbTicketSdk\Exception\ZzbTicketException`zzb-ticket-sdk`ZzbSdk\Model\*``ZzbTicketSdk\Model\*`zzb-ticket-sdk`ZzbSdk\ZzbService` (netsale2025)`NetsaleReportSdk\NetsaleReportClient`netsale-report-sdk`ZzbSdk\Config` (netsale2025)`NetsaleReportSdk\Config`netsale-report-sdk`ZzbSdk\Model\ZzbTicket``NetsaleReportSdk\Model\ReportTicket`netsale-report-sdk`ZzbSdk\Model\ZzbResult``NetsaleReportSdk\Model\ReportResult`netsale-report-sdk`ZzbSdk\Signer\VstkSignerInterface``NetsaleReportSdk\Signer\VstkSignerInterface`netsale-report-sdk#### 3. 配置变更

[](#3-配置变更)

**购票 / 交易（zzb-ticket-sdk）**：

- 移除 `mode` 配置（不再需要，纯 legacy）
- 移除 `vstkSignerUrl` 配置（V-STK 签名属于上报包）

**票房上报（netsale-report-sdk）**：

- 移除 `mode`、`appId`、`interfaceKey`、`certFilePwd`、`cssConfigFile` 等 legacy 字段
- 证书只支持 PEM 格式（`certFile` + `keyFile` 分离），不再处理 PFX/P12
- `downloadReportRecord` 需要配置 `vstkSigner`（实现 `VstkSignerInterface`）

#### 4. 方法变更

[](#4-方法变更)

**购票 / 交易包**保留了所有查询和交易方法，以及 legacy 模式的上报方法：

- `getCinemaInfo`、`getScreenInfo`、`downloadFilmInfo`
- `querySessionInfo`、`queryScreenSeatInfo`、`querySeatStatusInfo`
- `lockSeatsInfo`、`releaseSeatsInfo`、`submitOrder`
- `queryOrderInfo`、`refundTicket`、`refundTicketByLockOrderId`
- `reportTicket`（legacy）、`reportTicketByLockOrderId`
- `downloadReportRecord`（legacy）

**上报包**只保留两个方法：

- `reportTicket` — 2025 协议售票 / 退票上报
- `downloadReportRecord` — 2025 协议比对文件下载（需 V-STK 签名）

旧包中的混合模式方法（`reportTicketByLockOrderId`、`refundReportTicketByLockOrderId` 等"先查单再上报"的方法）不再包含在上报包中，由业务层自行编排查询和上报。

### 旧版本归档

[](#旧版本归档)

旧包的最后版本为 `v2.0.4`，已归档在此仓库中。如果需要回退，可以使用：

```
composer require kylin987/zzb-sdk-php:^2.0
```

但不建议长期使用旧包，新包的代码更清晰、依赖更少。

License
-------

[](#license)

MIT

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance91

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~12 days

Recently: every ~0 days

Total

8

Last Release

51d ago

Major Versions

v0.1.0 → v1.0.02026-03-24

v1.0.1 → v2.0.02026-06-15

### Community

Maintainers

![](https://www.gravatar.com/avatar/7f1c0726daff91d74835f3ef3901923fdf7b6b0b65d919968682b53edd22c9cc?d=identicon)[kylin987](/maintainers/kylin987)

---

Top Contributors

[![kylin987](https://avatars.githubusercontent.com/u/26080774?v=4)](https://github.com/kylin987 "kylin987 (11 commits)")

---

Tags

phpsdkcinemazzb

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/kylin987-zzb-sdk-php/health.svg)

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

###  Alternatives

[deepseek-php/deepseek-php-client

deepseek PHP client is a robust and community-driven PHP client library for seamless integration with the Deepseek API, offering efficient access to advanced AI and data processing capabilities.

47494.5k5](/packages/deepseek-php-deepseek-php-client)[jstolpe/instagram-graph-api-php-sdk

Instagram Graph API PHP SDK

138114.7k2](/packages/jstolpe-instagram-graph-api-php-sdk)[octw/aramex

A Library to integrate with Aramex APIs

3028.9k](/packages/octw-aramex)

PHPackages © 2026

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