Download the PHP package turahe/otp without Composer
On this page you can find all versions of the php package turahe/otp. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package otp
Short Description A robust Laravel package for generating and validating One-Time Passwords (OTP) with email integration, automatic cleanup, and comprehensive testing support for PHP 8.2+
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package otp
Laravel OTP ▲
Introduction 🖖
A robust Laravel package for generating and validating OTPs (One Time Passwords) with comprehensive test coverage and modern CI/CD pipeline. Perfect for authentication systems, email verification, and secure access control.
Features ✨
- 🔐 Secure OTP Generation: 6-digit numeric tokens with configurable expiry
- 📧 Email Integration: Built-in email sending with customizable templates
- 🧪 Comprehensive Testing: 126+ tests with 100% coverage of core functionality
- 🚀 Modern CI/CD: GitHub Actions with PHP 8.2-8.4 and Laravel 10-12 support
- 📱 Flexible Identity: Support for email, phone numbers, or any string identifier
- ⏰ Automatic Cleanup: Scheduled cleanup of expired tokens
- 🎨 PSR-12 Compliant: Clean, maintainable code following Laravel best practices
Requirements 📋
- PHP: ^8.2
- Laravel: ^10.0 || ^11.0 || ^12.0
- Database: MySQL, PostgreSQL, SQLite, or SQL Server
Installation 💽
1. Install via Composer
2. Add Service Provider
Add to config/app.php providers array:
3. Add Facade Alias (Optional)
Add to config/app.php aliases array:
4. Publish Configuration (Optional)
5. Run Migrations
Configuration ⚙️
The package configuration file (config/otp.php) allows you to customize:
Usage 🧨
Basic OTP Generation
OTP Validation
Email Integration
Custom Email Templates
The package includes a default email template at resources/views/emails/otp.blade.php. You can customize it by publishing the views:
Cleanup Expired Tokens
Testing 🧪
The package includes comprehensive test coverage organized into Unit and Feature tests:
Test Structure
Unit Tests (tests/Unit/) - Isolated class testing
- Helper Functions: Phone validation, email provider extraction, disposable email detection
- Token Service: OTP generation, validation, expiry handling, serialization
Feature Tests (tests/Feature/) - Integration testing
- SendOtp Job: Email queuing, parameter handling, edge cases
- RemoveInvalidateOtp Command: Expired token cleanup, batch processing
Test Coverage Summary
- Total Tests: 126
- Total Assertions: 274
- Code Coverage: Core functionality fully covered
- PHP Versions: 8.2, 8.3, 8.4
- Laravel Versions: 10.x, 11.x, 12.x
CI/CD Pipeline 🚀
Continuous Integration
The GitHub Actions workflow runs on every push and pull request:
- Matrix Testing: PHP 8.2, 8.3, 8.4 × Laravel 10, 11, 12
- Code Quality: PHP CS Fixer (PSR-12) and PHPStan Level 8 static analysis (zero errors)
- Security: Composer security audit
- Validation: Composer.json validation and lock file checks
Release Management
Automated releases are created when semantic version tags are pushed:
Local Development
Run the same checks locally:
API Reference 📚
Otp Facade
| Method | Parameters | Returns | Description |
|---|---|---|---|
generate() |
string $identity, int $expiresAt = 15 |
OtpToken |
Generate new OTP |
validate() |
string $identity, string $token |
bool |
Validate OTP |
Token Service
| Method | Parameters | Returns | Description |
|---|---|---|---|
identity() |
- | mixed |
Get token identity |
token() |
- | string |
Get token value |
plainText() |
- | string |
Get plain text token value |
expired() |
- | bool |
Check if token expired |
timeLeft() |
- | int |
Get seconds until expiry |
Helper Functions
| Function | Parameters | Returns | Description |
|---|---|---|---|
validation_number() |
string $number, string $country = 'ID' |
bool |
Validate phone number |
format_number() |
string $number, string $country = 'ID' |
string |
Format phone number |
get_email_provider() |
string $email |
string |
Extract email provider |
validate_email() |
string $email |
bool |
Check if email is disposable |
Examples 📝
Authentication Flow
Phone Number Validation
Email Provider Detection
Contributing 🤝
We welcome contributions! Please see our contributing guidelines:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes
- Add tests for new functionality
- Ensure all tests pass (
composer test) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Development Setup
Security 🔒
If you discover any security-related issues, please email [email protected] instead of using the issue tracker.
License 📄
This package is open-sourced software licensed under the MIT license.
Support 💬
- Documentation: GitHub Wiki
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Changelog 📋
See CHANGELOG.md for a detailed history of changes.
Made with ❤️ by Turahe
All versions of otp with dependencies
giggsey/libphonenumber-for-php Version ^8.0|^9.0
illuminate/container Version ^10.0|^11.0|^12.0
illuminate/notifications Version ^10.0|^11.0|^12.0
illuminate/support Version ^10.0|^11.0|^12.0