Stars: 147
Forks: 43
Pull Requests: 15
Issues: 5
Watchers: 8
Last Updated: 2023-09-16 17:27:19
OTP generator and validator
License:
Languages: PHP
This is a simple package to generate and validate OTPs (One Time Passwords). This can be implemented mostly in Authentication.
Install via composer
composer require ichtrojan/laravel-otp
Add service provider to the config/app.php
file
<?php
/*
|--------------------------------------------------------------------------
| Autoloaded Service Providers
|--------------------------------------------------------------------------
|
| The service providers listed here will be automatically loaded on the
| request to your application. Feel free to add your own services to
| this array to grant expanded functionality to your applications.
|
*/
'providers' => [
...
Ichtrojan\Otp\OtpServiceProvider::class,
];
...
Add alias to the config/app.php
file
<?php
/*
|--------------------------------------------------------------------------
| Class Aliases
|--------------------------------------------------------------------------
|
| This array of class aliases will be registered when this application
| is started. However, feel free to register as many as you wish as
| the aliases are "lazy" loaded so they don't hinder performance.
|
*/
'aliases' => [
...
'Otp' => Ichtrojan\Otp\Otp::class,
];
...
Run Migrations
php artisan migrate
octicon-info mr-2" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">
Response are returned as objects. You can access its attributes with the arrow operator (->
)
<?php
Otp::generate(string $identifier, int $digits = 4, int $validity = 10)
$identifier
: The identity that will be tied to the OTP.$digit (optional | default = 4)
: The amount of digits to be generated, can be any of 4, 5 and 6.$validity (optional | default = 10)
: The validity period of the OTP in minutes.<?php
$otp = Otp::generate('[email protected]', 6, 15);
This will generate a six digit OTP that will be valid for 15 minutes and the success response will be:
{
"status": true,
"token": "282581",
"message": "OTP generated"
}
<?php
Otp::validate(string $identifier, string $token)
$identifier
: The identity that is tied to the OTP.$token
: The token tied to the identity.<?php
$otp = Otp::validate('[email protected]', '282581');
On Success
{
"status": true,
"message": "OTP is valid"
}
Does not exist
{
"status": false,
"message": "OTP does not exist"
}
Not Valid*
{
"status": false,
"message": "OTP is not valid"
}
Expired
{
"status": false,
"message": "OTP Expired"
}
You can delete expired tokens by running the following artisan command:
php artisan otp:clean
You can also add this artisan command to app/Console/Kernel.php
to automatically clean on scheduled
<?php
protected function schedule(Schedule $schedule)
{
$schedule->command('otp:clean')->daily();
}
If you find an issue with this package or you have any suggestion please help out. I am not perfect.