Laravel 唯一令牌生成器

1.0 2020-04-03 21:54 UTC

This package is auto-updated.

Last update: 2024-09-25 08:01:21 UTC


README

Laravel

Total Downloads

Laravel 唯一令牌生成器

// Generate unique Token From Database.
$new_token = $token->Unique($table_name, $column_name, $size);

安装

使用 Composer 在项目的根目录中安装此包。

$ composer require olakunlevpn/token

将服务提供者添加到 config/app.php 中的 providers 数组中,或者如果您使用的是 Laravel 5.5,可以通过自动包发现来完成此操作。

Olakunlevpn\Token\TokenServiceProvider::class

如果您想使用 门面,可以在 config/app.php 中添加引用到您的别名数组。

'Token'=>\Olakunlevpn\Token\Facades\Facade::class

文档

★ 新的 Token 特性 ★

在模型中设置

要使用新的 token 特性,您需要对包含 token 字段的模型进行一些更改。

单列 token
单个 token 特性允许您为表中的一个列生成 token
  • 要使用单列 token,您需要在模型中添加 use OlakunlevpnToken;
  • 在数据库中,我们使用默认的列名为 dt_token,将其替换为您的列名,在模型中添加 protected $DT_Column='column_name';
  • Token 设置默认为这个值 ['type' => DT_Unique, 'size' => 40, 'special_chr' => false],要替换为您的自定义设置,在模型中添加 protected $DT_settings=['type' => DT_Unique, 'size' => 60, 'special_chr' => false];
  • 您应该知道我们使用自定义常量来表示我们的 token 类型
  Const DT_Unique = 'Unique'; 
  Const DT_UniqueNum = 'UniqueNumber'; 
  Const DT_UniqueStr = 'UniqueString';
  Const DT_Random = 'Random';
  Const DT_RandomNum = 'RandomNumber';
  Const DT_RandomStr = 'RandomString';
  • 在准备模型以在您的代码中使用我们的 trait token 之后,您可以像这样设置 token,使用您的自定义列和设置
           $user=User::first();
           $user->setToken();
           $user->save();
  • 您可以在 setToken(); 函数中使用您自己的自定义设置,如下所示
           $user=User::first();
           $user->setToken(DT_UniqueStr,100,false);
           $user->save();
  • 您可以在该函数中设置您自己的自定义列
           $user=User::first();
           $user->setToken(DT_UniqueStr,100,false,'column_name');
           $user->save();
  • 要获取带有 token 的模型查询,您可以使用 WithToken()$user=User::WithToken()->get();
  • 要获取不带 token 的模型查询,您可以在 WithToken() 中使用标志 false$user=User::WithToken(false)->get();
多列 token
多 token 允许您为同一表中的多个列生成 token
  • 要使用多列 token,您需要在模型中添加 use OlakunlevpnMultiToken;
  • 列设置默认未设置,因此您需要在模型中创建自己的设置
  protected $DMT_columns=[
        'unique_id'=>['type'=>DT_Unique,'size'=>60,'special_chr'=>false],
        'unique_uid'=>['type'=>DT_Unique,'size'=>30,'special_chr'=>false],
    ];
  • 您应该知道我们使用自定义常量来表示我们的 token 类型
      Const DT_Unique = 'Unique'; 
      Const DT_UniqueNum = 'UniqueNumber'; 
      Const DT_UniqueStr = 'UniqueString';
      Const DT_Random = 'Random';
      Const DT_RandomNum = 'RandomNumber';
      Const DT_RandomStr = 'RandomString';
    • 在准备模型以在您的代码中使用我们的 multi token 特性之后,您可以使用一个函数设置 token
               $user=User::first();
               $user->setTokens();
               $user->save();

★ 旧方法 ★

生成唯一 token

使用此包,您可以通过使用 unique($table_name,$column_name,$size) 函数生成唯一 token,该 token 在数据库中不重复。其中 $table_name 是数据库中的表名,$column_name 是表中的列名,$size 是 token 的大小。

生成唯一字符串 token

使用 UniqueString($table_name,$column_name,$size) 函数生成具有与唯一 token 相同签名的唯一字符串 token。

生成唯一整数 token

使用 UniqueNumber($table_name,$column_name,$size) 函数生成具有与唯一 token 相同签名的唯一整数 token。

生成随机 token

使用 Random($size) 函数生成随机 token,其中 $size 是 token 长度。

生成随机整数 token

使用 RandomNumber($size) 函数生成随机整数 token,其中 $size 是 token 长度。

生成随机字符串 token

使用 RandomString($size) 函数生成随机字符串 token,其中 $size 是 token 长度。

特殊字符

使用 true 允许在所有函数中使用特殊字符(如 !@#$%^&*())在 token 中,就像 Random($size,true) 一样。

示例

在这里,您可以看到一个示例,看看这个包是如何简单易用的。

唯一令牌

// Generate unique token not rebeated in database table with column name 
Token::Unique($table_name, $column_name, 10 );
//Result: fCWih6TDAf


// Generate unique integer token not rebeated in database table with column name
Token::UniqueNumber($table_name, $column_name, 10 );
//Result: 9647307239


// Generate unique string token not rebeated in database table with column name
Token::UniqueString($table_name, $column_name, 10 );
//Result: SOUjkyAyxC


//You can use special characters just add "true" to the function
Token::Unique($table_name, $column_name, 10,true );
//Result: H@klU$u^3z

随机令牌(非唯一)

$size=10;
// Generate random token 
Token::Random($size);

// Generate random integer token
Token::RandomNumber($size);

// Generate random string token
Token::RandomString($size);

//You can use special characters just add "true" to the function
Token::Random($size,true);

许可证

MIT © Olakunlevpn