php sm4加密库怎么选？推荐几个好用的PHP库。

发布日期： 2025-10-04 阅读量： 作者： admin

今天得空，正好把我前两天捣鼓 PHP 实现 SM4 加密那事儿给记录一下，省得以后忘了。

为啥要弄这个

起因很简单，最近手头有个活儿，对方要求数据传输得用国密 SM4 来加密。以前接触的大多是 AES 这类的，SM4 还真是头一回在 PHP 项目里碰见。没办法，客户要求，硬着头皮也得上。

找轮子阶段

第一反应肯定是找找看有没有现成的库可以用。PHP 这方面生态还行，我就上网搜了一圈。嚯，还真不少，有说用 phpseclib 的，有推荐一些专门针对国密算法的包，比如叫什么 `sm4-php` 之类的，还有提到 PHP 底层的 OpenSSL 扩展好像也能支持。看得我有点眼花缭乱，不知道哪个靠谱。

我这个人，有点怕麻烦，不太想引入太多新的依赖库，怕万一有坑或者跟项目里其他东西冲突。我就琢磨着，能不能先试试 PHP 自带的 OpenSSL。印象里 OpenSSL 挺强大的，支持的加密算法应该不少。

动手实践：OpenSSL 的尝试

查了下文档，发现 PHP 的 `openssl_encrypt()` 和 `openssl_decrypt()` 函数确实可以指定加密方法。但是 SM4 这种，文档里没直接写出来，得自己去找支持列表。后来发现，确实是支持的，不过得用特定的字符串名字，比如 sm4-cbc 或者 sm4-ecb 这种。

行，那就开干。先把密钥（key）和初始向量（IV）准备这个对方提供了。然后就开始写代码：

$data = '这是我要加密的内容';

$key = '这里是密钥，得是16字节'; // SM4 密钥长度是 128 位，也就是 16 字节

$iv = '这里是初始向量，也是16字节'; // CBC 模式需要 IV

$method = 'sm4-cbc'; // 或者 sm4-ecb，看具体要求

然后调用 `openssl_encrypt()` 函数：

$encrypted = openssl_encrypt($data, $method, $key, OPENSSL_RAW_DATA, $iv);

这里有个小坑，那个选项 OPENSSL_RAW_DATA 很重要，不然默认会给你进行 Base64 编码，可能跟对方要求的格式不一样。还有就是填充（Padding）的问题，OpenSSL 默认是用 PKCS7 填充，如果对方要求别的填充方式，比如 ZeroPadding，那就得自己处理或者在选项里找找有没有对应的，比如 OPENSSL_ZERO_PADDING。

加密完了，得到一串二进制数据。通常需要再用 Base64 转一下，方便传输：

$encrypted_base64 = base64_encode($encrypted);

解密过程就反过来：

$encrypted_from_base64 = base64_decode($encrypted_base64);

$decrypted = openssl_decrypt($encrypted_from_base64, $method, $key, OPENSSL_RAW_DATA, $iv);

踩坑与调试

看起来挺顺畅是？实际操作起来还是费了点劲。一开始密钥长度弄错了，搞成了 32 字节，结果运行直接报错。后来发现 SM4 固定就是 16 字节密钥。

然后是 IV，如果用 ECB 模式是不需要 IV 的，但我一开始没注意，传了个 IV 进去，虽然没报错，但结果肯定不对。后来切换到 CBC 模式，IV 就必须得有，而且也得是 16 字节。

最大的坑还是在填充和最终输出格式上。对方给的 Java 程序加密出来的结果，跟我用 PHP `openssl_encrypt` 直接生成的 Base64 对不上。调试了半天，抓包、打日志，一点点对比。发现是 PHP 默认用了 PKCS7 填充，而对方那边可能没用填充或者是用的 ZeroPadding。还有就是 `OPENSSL_RAW_DATA` 这个选项，一开始忘了加，PHP 自动做了 Base64，导致解码的时候又多了一层 Base64，怎么都对不上。

后来把选项都设置对（用了 `OPENSSL_RAW_DATA`，并且确认了填充方式一致，如果不一致可能需要手动填充或取消填充），再进行 Base64 编码，终于跟对方给的示例结果对上了。

最终成果与总结

折腾了一下午，总算是把 PHP 用 OpenSSL 实现 SM4 加密解密给跑通了。主要就是下面几点：

确认 PHP 环境的 OpenSSL 扩展是开启的，并且版本别太老旧。
搞清楚加密模式（ECB、CBC 等），SM4 常用的是这两种。
密钥（key）必须是 16 字节。
如果是 CBC 模式，初始向量（IV）也必须是 16 字节，并且每次加密最好用不同的 IV。
注意 `openssl_encrypt` 和 `openssl_decrypt` 函数的选项参数，特别是 OPENSSL_RAW_DATA 和可能的填充选项（如 OPENSSL_ZERO_PADDING）。如果默认的 PKCS7 填充不符合要求，可能需要手动处理填充。
输出格式要确认清楚，是原始二进制、Hex 编码还是 Base64 编码。

虽然过程有点曲折，但最终还是用 PHP 自带的 OpenSSL 搞定了，避免了引入新的库。感觉 PHP 对国密算法的支持虽然有，但文档说明和易用性上还是稍微差了点意思，不像 AES 那么开箱即用。不过好在是解决了，也算积累了点经验。

好了，今天就记录到这，希望能给后面可能遇到类似问题的朋友一点参考。下次再碰到别的有意思的技术实践，再来分享。

上一篇: seo关键词优化企业服务怎么样？看看真实案例就知道！

php sm4加密库怎么选？推荐几个好用的PHP库。

随便看看