PHPackages                             hon/phpsm - 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. [Security](/categories/security)
4. /
5. hon/phpsm

ActiveLibrary[Security](/categories/security)

hon/phpsm
=========

国密sm2 SM2withSM3

v1.2.3(4y ago)2326MITPHPPHP >=7.0.0

Since Jul 7Pushed 4y agoCompare

[ Source](https://github.com/hon94csl/phpsm2sm3sm4)[ Packagist](https://packagist.org/packages/hon/phpsm)[ RSS](/packages/hon-phpsm/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (5)Dependencies (1)Versions (11)Used By (0)

说明：
===

[](#说明)

本项目由lpilp大佬以下项目fork而来

- 原项目要求PHP版本最低为 php7.2，本项目是为了适配php7 而做修改。
- 改动部分主要是 降级 类常量声明语法 移除私有声明
- 理论上 可以支持php7 序列 版本

php sm2 sm3 sm4 国密算法整理
======================

[](#php-sm2-sm3-sm4-国密算法整理)

- 本项目支持php版本的国密sm2的签名算法，非对称加解密算法（非对称加密刚上线，目前测试无问题，不能保证兼容其他语言，有问题可以提issues），sm3的hash, sm4的对称加解密，要求PHP７，打开gmp支持
- 目前如果服务器配套的使用的是openssl 1.1.1x, 目前到1.1.1.l(L) ,sm3,sm4都可以直接用openssl\_xxx系列函数直接实现，不必大量的代码,但不支持sm2的签名，sm2的加解密
- 有一个sm3, sm4的比较好的代码：  可以使用composer安装，只是这个的ecb, cbc没有做补齐

### 使用(how to use)

[](#使用how-to-use)

- composer require hon/phpsm
- please make sure you upgrade to Composer 2+
- PHP >=7.0
- 如过需要使用 PHP7.2 或更高版本的 ，请使用原版 composer require lpilp/guomi ;
- 如需要使用php5.6 请使用wzhih童鞋fork修改的  ; composer require wzhih/guomi

### SM2

[](#sm2)

- 签名验签算法主体基于PHPECC算法架构，添加了sm2的椭圆参数，
- 参考了  童鞋的sm2验签算法，密钥生成算法
- 添加了签名算法， 支持sm2的16进制，base64公私钥的签名，验签算法
- 支持从文件中读取pem文件的签名，验签算法
- 添加了sm2的非对称加密的算法，但速度一般，有待优化，不能保证兼容所有语言进行加解密，目前测试了js, python的相互加解密
- sm2的加密解密算法在openssl 1.1.1的版本下自带的函数中暂无sm2的公钥私钥的加密函数，得自己实现，建议使用C，C++的算法，打包成PHP扩展的方式
- 由于 openssl没有实现sm2withsm3算法，用系统函数无法实现签名及证书的自签名分发

### SM3

[](#sm3)

- 该算法直接使用  中sm2签名用到的匹配sm3, 未做修改
- 也可使用 openssl的函数, 详见openssl\_tsm3.php

### SM4

[](#sm4)

- 该算法直接封装使用  的sm4算法， 同时该项目支持 sm3,sm4 ,可以composer安装
- 由于sm4-ecb, sm4-cbc加密需要补齐，项目lizhichao/sm项目未做补齐操作，这里封装的时候，针对这两个算法做了补齐操作， 其他如sm4-ctr,sm4-cfb,sm4-ofb等，可以直接用
- 在openssl 1.1.1下可使用系统的函数，已支持sm4-cbc,sm4-cfb,sm4-ctr,sm4-ecb,sm4-ofb， 详见openssl\_tsm4.php

### SM2各语言总结

[](#sm2各语言总结)

- 这里封装的测试函数已与相关的js, python, java,go等都可以互签互认
- js:  一个注意点就是： js的中文字符转成byte\[\]时，缺省的是unicode编码两字节，需要转成utf8的三字节编码，一个简单的方案 unescape(encodeURIComponent(str)) 然后再一个字节一个字节读就行了
- python:  使用 pip install gmssl 安装就可， 注意的就是在python2下 ， string与byte\[\] 是可以隐式转换的，在python3下需要显式地将string转成byte\[\]
- java:  注意下java中文的转码问题，getBytes("UTF-8"), 要加上编码类型， 因为 getBytes()函数的缺省编码是随操作系统的，如果是在中文版的windows中使用，缺省是GBK编码，就会出现中文的编码的问题，而造成签名无法通过
- openssl: 升到1.1.1以后，支持sm3,sm4的加解密，还不支持sm2的公私钥加解密，也不支持sm2的签名，得使用原生代码实现，签名中需要实现sm2withsm3, openssl1.1.1只实现了sm2whithsha256;还有一点很诡异，用yum/dnf安装的openssl只支持sm3, 如果是自己编译安装的就支持sm3,sm4

- go:  一家做区块链的公司开源的项目，在go方面可以说是最早开源的了，sm2主要有两个问题：
    1. 暂无使用外部密码明文生成公私钥构造函数，比较简单可自行添加
    2. sm2的非对称加解密例子中使用EncryptAsn1这个函数，asn1是将 c1拆开为px,py两部分，asn1(px,py,c3,c2)的编码；在sm2类中也有直接Encrypt函数，生成的是'\\x04'+c1+c3+c2 与其它语言生成的加密串在c1部分多加了一个\\x04, 看互通代码的需求自行处理
    3. 签名与验签的方法可与本项目的PHP语言是互签互认的
    4. sm4的对称加解密cbc等需要IV向量的模式，将iv做为全局变量了，对于不同的串要使用不同的iv时，就会出现麻烦，请根据需要修改代码，将iv加到参数里
- C#: 项目也比较少，基本是基于 的BC加密库(java也是基于该库),该库1.8.4后版本支持sm2,sm3,sm4,考察搜索到的几个项目， 完整性算比较好
    1. 项目提供sm2的签名，加解密都加入的项目，其他的项目里没有签名算法，sm2的加解密的返回值与上面的go项目一样返回的是asn1编码过的，如需要原始的请自行修改更新
    2. sm4的cbc的封装后把 key与iv弄成一个值了，如需要请自行修改更新

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 87.3% 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 ~36 days

Recently: every ~1 days

Total

10

Last Release

1494d ago

Major Versions

v0.1.0-alpha → v1.0.02021-10-12

PHP version history (3 changes)v1.0.0PHP >=7.4

1.0.3PHP >=7.2

v1.1PHP >=7.0.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/659199?v=4)[hon](/maintainers/Hon)[@hon](https://github.com/hon)

---

Top Contributors

[![lpilp](https://avatars.githubusercontent.com/u/36149355?v=4)](https://github.com/lpilp "lpilp (55 commits)")[![hon94csl](https://avatars.githubusercontent.com/u/15683014?v=4)](https://github.com/hon94csl "hon94csl (8 commits)")

### Embed Badge

![Health badge](/badges/hon-phpsm/health.svg)

```
[![Health](https://phpackages.com/badges/hon-phpsm/health.svg)](https://phpackages.com/packages/hon-phpsm)
```

###  Alternatives

[mews/purifier

Laravel 5/6/7/8/9/10 HtmlPurifier Package

2.0k18.7M143](/packages/mews-purifier)[paragonie/ecc

PHP Elliptic Curve Cryptography library

24820.0k37](/packages/paragonie-ecc)

PHPackages © 2026

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