olakunlevpn / token
Laravel 唯一令牌生成器
Requires
- php: >=5.6
This package is auto-updated.
Last update: 2024-09-25 08:01:21 UTC
README
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);