iroid/laravel-otp

一个简单的用于生成和验证一次性密码(OTP)的包

dev-main 2024-02-22 11:46 UTC

This package is auto-updated.

Last update: 2024-09-22 13:00:18 UTC


README

介绍 🖖

这是一个用于生成和验证一次性密码(OTP)的简单包。

安装 💽

通过composer安装

composer require iroid/laravel-otp

运行迁移

php artisan migrate

用法 🧨

注意
响应以对象的形式返回。您可以使用箭头操作符 (->) 访问其属性

生成OTP

<?php

use Iroid\Otp\Otp;

(new Otp)->(string $identifier, string $type, int $length = 4, int $validity = 10);
  • $identifier:将与其关联OTP的标识符。
  • $type:要生成的令牌类型,支持类型为numericalpha_numeric
  • $length (可选 | 默认 = 4):要生成的令牌长度。
  • $validity (可选 | 默认 = 10):OTP的有效期(分钟)。

示例

<?php

use Iroid\Otp\Otp;

(new Otp)->generate('michael@okoh.co.uk', 'numeric', 6, 15);

这将生成一个有效期为15分钟的六位OTP,成功响应将是

{
  "status": true,
  "token": "282581",
  "message": "OTP generated"
}

验证OTP

<?php

use Iroid\Otp\Otp;

(new Otp)->validate(string $identifier, string $token)
  • $identifier:与OTP关联的标识符。
  • $token:与身份关联的令牌。

示例

<?php

use Iroid\Otp\Otp;

(new Otp)->validate('michael@okoh.co.uk', '282581');

响应

成功

{
  "status": true,
  "message": "OTP is valid"
}

不存在

{
  "status": false,
  "message": "OTP does not exist"
}

无效*

{
  "status": false,
  "message": "OTP is not valid"
}

过期

{
  "status": false,
  "message": "OTP Expired"
}

删除过期的令牌

您可以通过运行以下artisan命令来删除过期的令牌

php artisan otp:clean

您还可以将此artisan命令添加到app/Console/Kernel.php中,以便在计划的时间内自动清理

<?php

protected function schedule(Schedule $schedule)
{
    $schedule->command('otp:clean')->daily();
}

贡献

有兴趣贡献或修改请与我联系 电子邮件