什么是 Sqids?

Sqids 是一个开源库,可以从数字生成短的唯一标识符。这些标识符是 URL 安全的,可以编码多个数字,并且不包含常见的粗话。 阅读更多 .

这就是它们的样子:

https://example.com/Lqj8a0

快速编码和解码示例:

sqids = Sqids.new
id = sqids.encode([1, 2, 3]) # "86Rf07"
numbers = sqids.decode(id) # [1, 2, 3]

如果 ID 太短,您可以将它们填充到一定长度:

sqids = Sqids.new(min_length: 10)
id = sqids.encode([1, 2, 3]) # "86Rf07xd4z"
numbers = sqids.decode(id) # [1, 2, 3]

通过洗牌字母表创建唯一的 ID:

sqids = Sqids.new(alphabet: "k3G7QAe51FCsPW92uEOyq4Bg6Sp8YzVTmnU0liwDdHXLajZrfxNhobJIRcMvKt")
id = sqids.encode([1, 2, 3]) # "XRKUdQ"
numbers = sqids.decode(id) # [1, 2, 3]

完整文档位于 https://github.com/sqids/sqids-crystal

如果您正在寻找原始的 Hashids Crystal,您可以在这里找到: https://github.com/splattael/hashids.cr

用途

Sqids 的主要用途是纯视觉的。如果您想在项目中使用标识符代替数字,Sqids 可能是一个不错的选择。

适用于

  • 编码主键 如果使用关系型数据库
  • 节省数据库查询 通过编码多个对象
  • 临时登录令牌 无粗话,URL 安全

不适用于

  • 敏感数据 这不是加密库
  • 用户 ID 如果有人找到编码字母表,可以显示用户计数

特性

  • 🆔 从非负数生成短 ID
  • 轻松编码和解码
  • 🫣 自动生成的 ID 不包含常见的粗话
  • 🎲 通过洗牌字母表支持自定义 ID
  • 🥳 44 集成 (75% 使用新设计)
  • 📌 每个版本生成相同的 ID
  • 🍻 小型库,采用宽松许可证

示例 / 游乐场