Skip to content

Latest commit

 

History

History
146 lines (131 loc) · 5.25 KB

CHANGELOG.md

File metadata and controls

146 lines (131 loc) · 5.25 KB
Raw

[v1.1.3] - 2020/11/06

这是一个常规的稳定性更新，没有不向后兼容的变更和新特性

近期原则上没有其他版本的更新计划

要点速览

  • 主要修复了一个 php5.5 之前 版本 生成摘要值错误 的问题
  • 当前 1.x 版本号不再保证 PHP 高版本的兼容性，高版本推荐使用 openssl 扩展
  • 完善的单元测试和 ci 的可用性
  • 更新了示例文件
  • 更新了协议
  • 增加了 Readme 中的徽标

更新记录

新增

  • 新增了用于单元测试的脚本
  • 添加了 docs/ 目录

变更

  • 更新了自动构建的逻辑，现在自动构建的产物会直接提交到 pre-build 分支，用于版本发布时的文件预构建
  • 更新了主方法参数的校验逻辑
  • 更新了 sm3() 主方法的测试用例
  • 更新了依赖版本
  • 修改了

废弃

  • 介于 phpunit 的兼容性，不再保证 php7.2+ 版本的兼容，1.x版本今后只作为低版本的兼容，

移除

  • 无

修复

  • #10 php 5.5 版本 unpack() 参数变更未做兼容导致 之前版本生成的摘要值错误 的问题

其他

  • 更新了示例中的文档
  • 更新了示例中的依赖版本
  • 修复文档中格式错乱的问题
  • 更新了协议

[v1.1.2] - 2020/07/06

新增

  • 添加了对于字符串 '010101' 的测试用例

修复

  • 合并了 pr #3 中， 二进制数未当做字符串处理的问题

[v1.1.1] - 2020/07/06

新增

  • 在 Composer 中添加了默认的阿里云镜像，方便使用
  • 添加了对于字符串'a a'的测试用例
  • 添加了对于字符串"a\r\na"、"a\ra"和"a\na"的测试用例

更改

  • 项目现在遵循PSR-12规范

废弃

  • 无

移除

  • 配置文件
  • 配置文件类
  • \SM3\types\ASCII类

修复

其他

关于待处理字符串中出现换行的说明

值得一提的是，由于算法是按位的，所以在处理不同系统中的换行时，需要区分 LF/CR/CRLF， 针对这三种系统中的换行，计算出来的值也是不同的。如：

array(
    array("a\na"=>'c413edbaa5449ada676857e243ae8d66401d82474cc68c243950178280bf7ae0'),
    array("a\ra"=>'75056f768d1ac970ef2faf58ae4be4666afc157e2cb87b9e08c526463bf787da'),
    array("a\r\na"=>'d1041bb570f8c65e26299159e41e21961d0ce4b79a285ee32c75c11eab0a2dd7')
)

其中，Linux（\n）下的值，与苍墨安全中的计算结果相同。

Windows（\r\n）下、OS X（\n）下和Classic Mac（\r）无对照结果，暂时未测试，欢迎反馈。

[v1.1] - 2019/11/26

新增

  • 添加了本 CHANGELOG.md 文件
  • 发布在了 Packagist 上
  • 添加了 examples/ 目录
    • 添加了 examples/sm3/ 目录， 进行了本库两种调用方式的用法示例，和区别说明
  • 添加了几个语法糖：
    • sm3 函数现可直接调用
      • 参数：待运算的 string 类型字符串
    • 二进制的与、或、非、异或、加算法：
      • 暂时返回32位长度的字符串，不够补0，超了保留从右往左数的32位。计划移除掉这个限制
        • 并非是运算过程中转换的32位，而是计算完之后转换的
      • binAdd 二进制加运算
        • 参数：由string 类型的二进制码组成的数组
        • 示例（以下的二进制与、或、加同理）： 
          $bin_sum = bin_add(array(
  '101111011110111',
  '0010110111',
  '1100010111101111011110111'
));

// 会输出32位的string类型二进制码
var_dump($bin_sum);
      • binAnd 二进制加运算
        • 参数：同 bin_add
        • 示例：同 bin_add
      • binOr 二进制或运算
        • 参数：同 bin_add
        • 示例：同 bin_add
      • binXor 二进制异或运算
        • 参数：同 bin_add
        • 示例：同 bin_add
      • binNot 二进制非运算
        • 参数：string 类型的二进制码
        • 示例：
        $bin_not = bin_not('1100010111101111011110111');

// 会输出32位的string类型二进制码
var_dump($bin_not);
      • binShiftLeft 二进制左移
        • 参数：
          • string 类型的二进制码
          • 需要左移的位数
        • 示例：
        $bin_shift_left = binShiftLeft('1101000',2);

// 会输出32位的string类型二进制码 
var_dump($bin_shift_left);

更改

  • 更新了 README.md 中的 安装 和 快速开始 中的安装/调用方法

废弃

  • 无

移除

  • 无

修复

其他

  • 无

[v1.0] - 2019/11/25

实现了国密 《SM3 信息摘要 算法》 的逻辑