授权协议: MPL
开发语言: PHP
操作系统: 跨平台
收录时间: 2020-08-18
提 交 者: 乱世之牙

SM3-PHP是国密标准SM3的原生PHP实现。

特点

  1. 纯原生 PHP 代码,不额外依赖扩展项;
  2. OOP + Composer ,更优雅,安装更简单;
  3. 使用命名空间,防止变量名、方法名污染;
  4. 引入了 Composer 的 PSR-4 规范,进行类的自动加载;
  5. 使用 PSR-12 代码规范
  6. 代码注释完整, 可配合《 SM3密码杂凑算法 》食用, 方便进一步学习和研究本算法。

要求

  • 5.3 <= php < 7.2

7.2 之后版本理论通过,但因为 phpunit 的版本兼容性问题,没有单元测试支撑

1.x 版本之后只会作为低版本兼容,2.x 及之后版本会对 PHP 更高版本做适配,使用更多新特性

安装

本库优先支持 Composer 安装,但为了尊重使用习惯,也提供了直接下载压缩包的方式。 但不得不说,Composer 式的以组件、包为单位的项目管理方式更加现代化、方便和优雅。

一、源码解压(不推荐)

  1. 下载压缩包

    提供了 .zip 和 .tar.gz 两种格式的压缩包, 压缩包已经过 Composer 包的优化

    下载地址:https://github.com/DongyunLee/SM3-PHP/releases/latest

  2. 解压到项目中的任意位置

    • Windows:

      使用 winrar/7zip/Bandizip 等工具解压

    • 类Unix:

      tar zxvf SM3-PHP.tar.gz
      # 或者
      unzip SM3-PHP.zip
    # 打包命令
    composer arch
    
    # 或 composer run-script arch

二、composer 安装(强烈推荐)

  1. 安装 composer

    详见 《如何安装 Composer

  2. 安装慢可更换中文镜像

    由于大量先前的镜像失效,所以目前(2019-11-25)推荐使用阿里云镜像

    其实配置中已经把镜像配置成了阿里云的镜像。 但有效范围毕竟只有这一个包。

    开发环境中还是建议进行下全局的配置。

    更换阿里云镜像方式详见拙笔 《向先行者致敬,迎接 Composer 的未来!

  3. composer require ch4o5/sm3-php

  4. composer install

  5. composer update

    下述 composer update 参数作为生产环境的优化,分析、调试和阅读代码无须使用

    参数简单说明:

    1. --prefer-dist:优先构建好的包,而不是源码
    2. --no-dev:不安装require-dev中定义的包,减小包的大小
    3. --no-plugins:不安装插件
    4. --with-dependencies:递归更新依赖的包
    5. --optimize-autoloader / -o:转换 PSR-0/4 autoload 到 classmap 可以获得更快的加载支持
    6. --classmap-authoritative推荐 使用后默认开启 -o,并对所有类加速

快速开始

在根目录中的 demo.php 中,进行了简单地调用示范:

<?php
/**
 * demo @ sm3-php
 *
 * Code BY ch4o5
 * 10月. 12th 2019
 * Powered by PhpStorm
 */

// 1. 引入项目中 Composer 的 autoload.php
require 'vendor/autoload.php';
// 2. 如果使用源码压缩包方式安装,则引入下面这句
// require '解压后的SM3-PHP目录/vendor/autoload.php';

// 直接调用提供的 sm3() 函数
$sm3 = sm3('abc');

// 使用它
echo $sm3;

你也可以在 examples/ 目录下找到更多的使用示例。

目录结构

  • examples/ 示例项目

  • src/ 源码目录,命名空间为SM3

  • vendor/ Composer自动加载相关

  • CHANGELOG.md 版本变更日志

  • composer.json Composer 配置文件

  • composer.lock Composer 锁文件,用于保证版本

  • demo.php 演示代码

  • LICENSE 开源许可证文件

  • README.md 本文件,项目说明

展开阅读全文

代码

的 Gitee 指数为
超过 的项目

SM3-PHP 的相关资讯

还没有任何资讯

SM3-PHP 的相关博客

SM3算法设计原理

SM3密码杂凑算法的描述 SM3密码杂凑算法采用Merkle-Damgard结构,消息分组长度为512b,摘要长度256b。压缩函数状态256b,共6...

AES SHA SM3 MD5

AES AES是美国国家标准技术研究所NIST旨在取代DES的21世纪的加密标准。 输入:128bit 的消息分组 输出:128bit 的密文分组 密...

sm1、sm2、sm3、sm4简单介绍

转自:https://blog.csdn.net/andylau00j/article/details/54427395 国密即国家密码局认定的国产密码算法。主要有SM1,SM2,S...

SM3加密算法开源项目推荐

来自ljgibbslf的github项目,知乎同名,欢迎star https://github.com/ljgibbslf/SM3_core 下面是项目的README SM3_core 国密 ...

国密算法SM3与SM4简介与应用

点击上方蓝字可直接关注!方便下次阅读。如果对你有帮助,麻烦点个在看或点个赞,感谢~ 最近0基础在学习国密算法的相关应用,...

关于国密算法 SM1,SM2,SM3,SM4 的笔记

关于国密算法 SM1,SM2,SM3,SM4 的笔记 摘自:https://www.cnblogs.com/TaiYangXiManYouZhe/p/4317519.html 国密即国家密码...

商密算法SM2、SM3、SM4的用途和原理

SM1对称密码 SM1 算法是分组密码算法,分组长度为128位,密钥长度都为 128 比特,算法安全保密强度及相关软硬件实现性能与 AE...

SM3国密算法标准中两个实例的实现

来源于CSDN博客:https://blog.csdn.net/ErErFei/article/details/50998162 代码新增内容:在原博客的基础上,整合了各个类的...

java sm3加密算法

java sm3加密算法实现 CreationTime--2018年7月13日09点28分 Author:Marydon 1.准备工作     所需jar包:   bcprov-jd...

SM3-PHP 的相关问答

还没有任何问答,马上提问

评论 (0)

加载中
更多评论
0 评论
4 收藏
分享
返回顶部
顶部