sqids php

其他类别 2025-08-24

sqids php

SQID(发音为“ Squids” )是一个小库,可让您从数字中生成唯一的ID 。它非常适合链接缩短,快速和网址安全ID生成,并将解码为数字,以获取更快的数据库查找。

特征:

  • 编码多个数字- 从一个或几个非负号生成短ID
  • 快速解码- 轻松将ID解码为数字
  • 唯一的ID-通过将字母放置一次来生成唯一的ID
  • ID填充- 提供最小长度以使ID更加均匀
  • URL安全- 自动生成的ID不包含共同的亵渎
  • 随机输出- 顺序输入提供非连续ID
  • 许多实现- 支持40多种编程语言

?用例

适合:

  • 生成公共URL的ID(例如:链接缩短)
  • 生成内部系统的ID(例如:事件跟踪)
  • 解码更快的数据库查找(例如:主键)

不适合:

  • 敏感数据(这不是加密库)
  • 用户ID(可以解码以显示用户数)

入门

在您的项目的根目录中需要此软件包,并带有作曲家。

composer require sqids/sqids

然后,您可以将课程导入您的应用程序:

 use Sqids  Sqids ;
$ sqids = new Sqids ();

重要的

SQID需要bcmathgmp扩展才能工作。

?‍例子

简单的编码和解码:

decode($id); // [1, 2, 3]">
 $ sqids = new Sqids ();
$ id = $ sqids -> encode ([ 1 , 2 , 3 ]); // "86Rf07"
$ numbers = $ sqids -> decode ( $ id ); // [1, 2, 3] 

笔记

?由于算法的设计,多个ID可以将其解码为相同的数字序列。如果对您的设计很重要的是ID是规范性的,则必须手动重新编码编码的数字并检查生成的ID匹配项。

为ID执行最小长度:

decode($id); // [1, 2, 3]">
 $ sqids = new Sqids (minLength: 10 );
$ id = $ sqids -> encode ([ 1 , 2 , 3 ]); // "86Rf07xd4z"
$ numbers = $ sqids -> decode ( $ id ); // [1, 2, 3]

通过提供自定义字母来随机化ID:

decode($id); // [1, 2, 3]">
 $ sqids = new Sqids (alphabet: ' FxnXM1kBN6cuhsAvjW3Co7l2RePyY8DwaU04Tzt9fHQrqSVKdpimLGIJOgb5ZE ' );
$ id = $ sqids -> encode ([ 1 , 2 , 3 ]); // "B4aajs"
$ numbers = $ sqids -> decode ( $ id ); // [1, 2, 3]

防止特定单词出现在自动生成的ID中的任何地方:

decode($id); // [1, 2, 3]">
 $ sqids = new Sqids (blocklist: [ ' 86Rf07 ' ]);
$ id = $ sqids -> encode ([ 1 , 2 , 3 ]); // "se8ojk"
$ numbers = $ sqids -> decode ( $ id ); // [1, 2, 3] 

执照

麻省理工学院

下载源码

通过命令行克隆项目:

git clone https://github.com/sqids/sqids-php.git