哈希模块

哈希模块提供了基于OpenSSL的密码学哈希函数功能。哈希函数可以将任意长度的数据映射为固定长度的散列值。

常见的哈希算法包括:

• MD5 (不再推荐使用)
• SHA-1 (不再推荐使用)
• SHA-256/SHA-384/SHA-512 (SHA-2系列)
• SHA3-256/SHA3-384/SHA3-512 (SHA-3系列)

API参考

导入模块

local hash = require "crypto.hash"

一次性计算哈希

local digest = hash.digest(algorithm, data)

对数据进行一次性哈希计算。

参数:

• algorithm: 哈希算法名称
• data: 要计算哈希的数据

返回:

• digest: 哈希值

创建哈希对象

local hasher = hash.new(algorithm)

创建一个新的哈希对象。

参数:

• algorithm: 哈希算法名称(如 "sha256"、"sha512"等)

Hash对象方法

update 更新数据

hasher:update(data)

向哈希对象添加要处理的数据。

参数:

• data: 要计算哈希的数据

final 完成哈希计算

local digest = hasher:final()

完成哈希计算并返回最终的哈希值。

返回:

• digest: 哈希值

reset 重置

hasher:reset()

重置哈希对象状态,可以重新使用。

digest 一次性计算

local digest = hasher:digest(data)

使用当前哈希对象对数据进行一次性哈希计算。

参数:

• data: 要计算哈希的数据

返回:

• digest: 哈希值

使用示例

一次性计算哈希

local hash = require "crypto.hash"

local data = "Hello World"
local digest = hash.digest("sha256", data)
print(string.format("%x", digest))

分块计算哈希

local hash = require "crypto.hash"

-- 创建SHA-256哈希对象
local hasher = crypto.hash.new("sha256")

-- 分块更新数据
hasher:update("Hello")
hasher:update(" ")
hasher:update("World")

-- 获取最终哈希值
local digest = hasher:final()
print(string.format("%x", digest))

-- 重置后可以重新使用
hasher:reset()
hasher:update("New Data")
local new_digest = hasher:final()