在当今高度互联的数字世界，数据安全和隐私保护的重要性不言而喻。对于许多企业，特别是那些涉及敏感数据或受监管的行业，仅仅使用国际通用的加密算法可能还不够。在中国，国家密码管理局（简称“国密局”）推出了一系列自主可控的密码算法，如SM3哈希算法和SM4对称加密算法，这些“国密算法”在特定应用场景下是强制性的合规要求。
然而，对于php开发者来说，要在项目中集成这些国密算法，往往会遇到不少挑战。你可能会发现：
- 缺乏原生支持：PHP标准库中并没有直接提供国密算法的实现，这意味着你不能像使用md5()或openssl_encrypt()那样直接调用。
- 实现难度大：从零开始实现复杂的密码学算法，不仅需要深厚的密码学知识，还容易引入安全漏洞，耗时耗力且风险极高。
- 性能瓶颈：即使找到一些第三方的PHP实现，其性能也可能不尽如人意，尤其是在处理大量数据时，可能会成为系统的瓶颈。
- 可靠性与维护：自行维护或依赖未经充分测试的实现，会给项目的长期稳定带来隐患。
面对这些困境，我们迫切需要一个既符合国密标准、又易于集成且性能优越的PHP解决方案。幸运的是，开源社区的力量再次展现，lizhichao/one-sm这个composer包应运而生，它为PHP开发者提供了一站式的国密算法解决方案。
Composer在线学习地址：学习地址
lizhichao/one-sm：你的国密算法救星
lizhichao/one-sm是一个专为PHP设计的国密算法库，它提供了SM3哈希和SM4加密的核心功能，完美解决了上述痛点。更重要的是，它通过Composer这个现代PHP包管理器，让集成变得前所未有的简单。
如何轻松引入？
立即学习“PHP免费学习笔记（深入）”；
只需一行Composer命令，你就能将lizhichao/one-sm引入你的项目：
composer require lizhichao/one-sm
Composer会自动处理依赖，并生成自动加载文件，你无需手动配置任何路径，即可在代码中直接使用库提供的功能。
one-sm的核心功能与实战
lizhichao/one-sm库主要提供了以下核心功能：
- SM3 哈希/签名：用于数据完整性校验，支持对字符串和文件进行签名。
- SM4 对称加密：用于数据加密传输和存储，支持ECB、CBC、CFB、OFB、CTR等多种加密模式。
让我们通过一些简单的代码示例，看看它是如何工作的：
1. SM3 字符串与文件签名
SM3算法主要用于数据完整性校验，确保数据在传输或存储过程中未被篡改。
<?php require __DIR__ . '/vendor/autoload.php'; use OneSmSm3; $sm3 = new Sm3(); // 字符串签名：生成一个固定长度的哈希值 $dataString = 'Hello, 国密算法世界！'; echo "字符串签名: " . $sm3->sign($dataString) . PHP_EOL; // 文件签名：对整个文件内容进行哈希 $filePath = __FILE__; // 对当前文件进行签名 echo "文件签名: " . $sm3->signFile($filePath) . PHP_EOL; ?>
性能表现亮眼：
lizhichao/one-sm在性能方面表现出色。根据库作者提供的基准测试结果，one-sm3在哈希计算速度上，与PHP内置的openssl函数（针对其他哈希算法）不相上下，并且远超其他纯PHP实现的SM3库。这意味着你无需担心性能瓶颈，可以放心地在生产环境中使用。
// 模拟测试结果，实际可能因环境而异 openssl time:6.3741207122803ms one-sm3 time:8.1770420074463ms SM3-PHP time:1738.5928630829ms
从上面的测试数据可以看出，one-sm3的性能表现非常接近openssl，而远优于另一个纯PHP实现的SM3-PHP，这对于需要高吞吐量加密的应用至关重要。
2. SM4 数据加密与解密
SM4算法是一种对称加密算法，适用于需要对数据进行机密性保护的场景。one-sm支持多种加密模式，以适应不同的安全需求。
<?php require __DIR__ . '/vendor/autoload.php'; use OneSmSm4; $originalData = str_repeat('这是一段需要加密的敏感数据，长度足够长以测试。', 10); $key = hex2bin(md5('your_secret_key_16')); // 加密key必须为16字节（128位） $sm4 = new Sm4($key); // 1. ECB模式加密与解密 (不推荐用于多块数据加密，因为它不使用IV) $encryptedEcb = $sm4->enDataEcb($originalData); $decryptedEcb = $sm4->deDataEcb($encryptedEcb); echo "ECB模式解密成功: " . (md5($decryptedEcb) === md5($originalData) ? '是' : '否') . PHP_EOL; // 2. CBC模式加密与解密 (推荐，需要初始化向量IV) $iv = hex2bin(md5('your_iv_16_bytes')); // 初始化向量IV也必须为16字节 $encryptedCbc = $sm4->enDataCbc($originalData, $iv); $decryptedCbc = $sm4->deDataCbc($encryptedCbc, $iv); echo "CBC模式解密成功: " . (md5($decryptedCbc) === md5($originalData) ? '是' : '否') . PHP_EOL; // 库还支持CFB, OFB, CTR等模式，用法类似 ?>
通过上述示例，你可以看到lizhichao/one-sm的API设计简洁直观，即使是不熟悉国密算法的开发者，也能快速上手。
总结与展望
lizhichao/one-sm库的出现，极大地简化了PHP应用中集成国密算法的复杂性。它带来的优势显而易见：
- 合规性保障：直接支持SM3和SM4，满足国内相关法规和标准要求。
- 开发效率提升：通过Composer一键安装，简单api调用，省去了繁琐的算法实现和测试工作。
- 高性能表现：经过优化的算法实现，确保在实际应用中不会成为性能瓶颈。
- 可靠性与安全性：作为一个开源库，经过社区的检验，其可靠性通常高于自行实现的版本。
在构建需要高度安全保障和国密合规性的PHP应用时，lizhichao/one-sm无疑是一个值得信赖的强大工具。它让开发者能够专注于业务逻辑，而将复杂的密码学实现交给专业的库来处理，从而更高效、更安全地构建出符合时代需求的应用。有了Composer和lizhichao/one-sm，PHP在国密算法领域的应用将如虎添翼！
