Download the PHP package worksome/verify-by-phone without Composer
On this page you can find all versions of the php package worksome/verify-by-phone. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download worksome/verify-by-phone
More information about worksome/verify-by-phone
Files in worksome/verify-by-phone
Package verify-by-phone
Short Description Verify your users by call or SMS
License MIT
Homepage https://github.com/worksome/verify-by-phone
Informations about the package verify-by-phone
Verify your users by call or SMS
It's a common practice: a user signs up, you send an SMS to their phone with a code, they enter that code in your application and they're off to the races.
This package makes it simple to add this capability to your Laravel application.
Installation
You can install the package via composer:
You can publish the config file by running:
Configuration
This package is built to support multiple verification services. The primary service
is Twilio. You may configure the service in the config file at config/verify-by-phone.php
under driver
, or by using the dedicated .env
variable: VERIFY_BY_PHONE_DRIVER
.
twilio
To use our Twilio integration, you'll need to provide an account_sid
, auth_token
and verify_sid
. All of these can
be set in the config/verify-by-phone.php
file under services.twilio
.
Usage
To use this package, you'll want to inject the \Worksome\VerifyByPhone\Contracts\PhoneVerificationService
contract into your application. Let's imagine that you want to send the verification code in a controller method:
It's as simple as that! Note that we are using \Propaganistas\LaravelPhone\PhoneNumber
to safely parse numbers in
different formats.
Now, when a user receives their verification code, you'll want to check that it is valid. Use the verify
method for
this:
The first parameter is the phone number (again using \Propaganistas\LaravelPhone\PhoneNumber
), and the second is the
verification code provided by the user.
Validation rule
We offer a rule to make it easy to verify a verification code during validation.
Be aware that this rule will call the
verify
method of thePhoneVerificationService
contract, and likely will make an HTTP request.
If your data doesn't include the phone number, you may instead pass it in manually:
We extend the Rule
class for visual consistency with other rules, but you can also use the VerificationCodeIsValid
rule directly for
better IDE support:
This rule will also handle the case where the verification code has expired and return a suitable error message.
Artisan commands
This package ships with a couple of artisan commands that allow you to send and verify verification codes.
The verify command will return a console failure if verification fails.
Testing
When writing tests, you likely do not want to make real requests to services such as Twilio. To support testing, we
provide a
FakeVerificationService
that can be used to mock the verification service. To use it, you should set an env
variable
in your phpunit.xml
with the following value:
Alternatively, you may manually swap out the integration in your test via using the swap
method. The fake
implementation has some useful testing methods you can use:
You may execute this project's tests by running:
Changelog
Please see GitHub Releases for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Luke Downing
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of verify-by-phone with dependencies
illuminate/contracts Version ^10.0 || ^11.0
propaganistas/laravel-phone Version ^5.2
spatie/laravel-package-tools Version ^1.16
twilio/sdk Version ^6.44 || ^7.0