PHPackages maize-tech/laravel-magic-login - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Authentication & Authorization](/categories/authentication) 4. / 5. maize-tech/laravel-magic-login ActiveLibrary[Authentication & Authorization](/categories/authentication) maize-tech/laravel-magic-login ============================== Laravel Magic Login 2.3.0(10mo ago)1808.1k↓43.2%16[4 PRs](https://github.com/maize-tech/laravel-magic-login/pulls)MITPHPPHP ^8.1CI passing Since Dec 7Pushed 2mo ago5 watchersCompare [ Source](https://github.com/maize-tech/laravel-magic-login)[ Packagist](https://packagist.org/packages/maize-tech/laravel-magic-login)[ Docs](https://github.com/maize-tech/laravel-magic-login)[ RSS](/packages/maize-tech-laravel-magic-login/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (12)Versions (15)Used By (0) ![Social Card of Laravel Magic Login](/art/socialcard-light.png) Laravel Magic Login =================== [](#laravel-magic-login) [![Latest Version on Packagist](https://camo.githubusercontent.com/ce99b542dc37a6977fb2bf6dd60a003640d3f54a191cacfa6665102dceac743b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d61697a652d746563682f6c61726176656c2d6d616769632d6c6f67696e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/maize-tech/laravel-magic-login)[![GitHub Tests Action Status](https://camo.githubusercontent.com/636978af67d93b235eac82c5f0f3a3a3f803cc8e74c1530ae63e95ce2712bc98/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d61697a652d746563682f6c61726176656c2d6d616769632d6c6f67696e2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/maize-tech/laravel-magic-login/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/4ce19f69b25960e7a6745560dfe569ee1efbda66a20c0db84d92bb2937c14400/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d61697a652d746563682f6c61726176656c2d6d616769632d6c6f67696e2f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/maize-tech/laravel-magic-login/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/ef48f0d7234c1673ab455cc259fb4629f3a0ce363345a15d92b7703096ed90b5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d61697a652d746563682f6c61726176656c2d6d616769632d6c6f67696e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/maize-tech/laravel-magic-login) Easily add passwordless authentication into your application. Installation ------------ [](#installation) You can install the package via composer: ``` composer require maize-tech/laravel-magic-login ``` You can publish the config and migration files and run the migrations with: ``` php artisan magic-login:install ``` This is the contents of the published config file: ``` return [ /* |-------------------------------------------------------------------------- | Magic Login model |-------------------------------------------------------------------------- | | Here you may specify the fully qualified class name of the magic login | model. | By default, the value is Maize\MagicLogin\Models\MagicLogin::class | */ 'model' => null, /* |-------------------------------------------------------------------------- | Expiration time |-------------------------------------------------------------------------- | | Here you may specify the amount of minutes before the magic login link | expires. | By default, the value is 120 minutes (2 hours). | */ 'expiration' => null, /* |-------------------------------------------------------------------------- | Authentication guard |-------------------------------------------------------------------------- | | Here you may specify the guard you want to use to authenticate the user. | The guard name must be defined in your application's auth.php config file. | By default, the value is 'web'. | */ 'guard' => null, /* |-------------------------------------------------------------------------- | Default redirect url |-------------------------------------------------------------------------- | | Here you may specify the redirect url used by default if none is specified | when creating the magic link. | */ 'redirect_url' => null, /* |-------------------------------------------------------------------------- | Exception class |-------------------------------------------------------------------------- | | Here you may specify the default exception class used for all package | related exceptions. | Useful if you need to customize the http status code in case an exception | is thrown during the magic login process. | By default, the value is Illuminate\Routing\Exceptions\InvalidSignatureException::class | */ 'exception' => null, /* |-------------------------------------------------------------------------- | Force single link |-------------------------------------------------------------------------- | | Here you can specify whether a user can only have one valid magic link | at a time or not. | If true, when you generate a new magic link for a specific user all | previously generated links will be revoked. | By default, the value is true. | */ 'force_single' => null, /* |-------------------------------------------------------------------------- | Logins limit |-------------------------------------------------------------------------- | | Here you can specify the amount of logins a user can perform with the | same magic link. | Can be either -1, which lets the user login indefinitely, or any number | greater than or equal to 1. | By default, the value is -1. | */ 'logins_limit' => null, /* |-------------------------------------------------------------------------- | Send Notification Action |-------------------------------------------------------------------------- | | Here you can specify the fully qualified class name of a custom action | used to send the magic login email notification. | By default, the value is Maize\MagicLogin\Actions\SendMagicLinkAction::class */ 'send_notification_action' => null, /* |-------------------------------------------------------------------------- | Notification class |-------------------------------------------------------------------------- | | Here you can specify the fully qualified class name of the magic link | email notification. | By default, the value is Maize\MagicLogin\Notifications\MagicLinkNotification::class */ 'notification' => null, 'route' => [ /* |-------------------------------------------------------------------------- | Route method |-------------------------------------------------------------------------- | | Here you may specify the route's allowed methods. | By default, the value is 'GET'. | */ 'methods' => null, /* |-------------------------------------------------------------------------- | Route URI |-------------------------------------------------------------------------- | | Here you may specify the route's uri. | By default, the value is 'magic-login'. | */ 'uri' => null, /* |-------------------------------------------------------------------------- | Route name |-------------------------------------------------------------------------- | | Here you may specify the route's name. | By default, the value is 'magic-login'. | */ 'name' => null, /* |-------------------------------------------------------------------------- | Route controller |-------------------------------------------------------------------------- | | Here you may specify the fully qualified class name of a custom controller | class used to handle the magic login request. | By default, the value is Maize\MagicLogin\Http\Controllers\MagicLoginController::class. | */ 'controller' => null, /* |-------------------------------------------------------------------------- | Route middlewares |-------------------------------------------------------------------------- | | Here you may specify the list of middlewares used by the magic login route. | By default, the value is Maize\MagicLogin\Http\Middleware\ValidateSignature::class. | */ 'middleware' => null, ], ]; ``` Usage ----- [](#usage) ### Basic [](#basic) To use the package, all you have to do is include the magic link route in your routes file. By default, you should include it under `routes/web.php`: ``` use Maize\MagicLogin\Facades\MagicLink; MagicLink::route(); ``` That's it! Once done, you can already generate an invitation link to any model extending the `Authenticatable` class using the `make` method: ``` use App\Models\User; use Maize\MagicLogin\Facades\MagicLink; $user = User::firstOrFail(); $magicLink = MagicLink::make( authenticatable: $user ); ``` ### Email notifications [](#email-notifications) #### Send an email notification [](#send-an-email-notification) Optionally, you may also automatically send an email notification to the given user using the `send` method: ``` use App\Models\User; use Maize\MagicLogin\Facades\MagicLink; $user = User::firstOrFail(); $magicLink = MagicLink::send( authenticatable: $user ); ``` which is equals to using the `make` method with the `notify` parameter set to `true`: ``` use App\Models\User; use Maize\MagicLogin\Facades\MagicLink; $user = User::firstOrFail(); $magicLink = MagicLink::make( authenticatable: $user, notify: true ); ``` #### Customize the notification class [](#customize-the-notification-class) When needed, you can customize the email notification. All you have to do is create your own notification and override the default `MagicLinkNotification` class: ``` use Illuminate\Notifications\Messages\MailMessage; use Maize\MagicLogin\Notifications\MagicLinkNotification as BaseMagicLinkNotification; class MagicLinkNotification extends BaseMagicLinkNotification { public function toMail($notifiable): MailMessage { return (new MailMessage) ->line(__('This is my custom magic link notification message')) ->action(__('Join now'), $this->uri); } } ``` Finally, you can update the `notification` attribute under `config/magic-login.php` with the new class path. ### Force single link [](#force-single-link) When enabled, users can only have one valid link at a time. This means that when a new link is created, all previously created links are invalidated. To enable this option, you can set the `force_single` attribute under `config/magic-login.php` to `true`. ### Magic link generator options [](#magic-link-generator-options) The package offers many useful parameters for the `make` method to allow you customizing every single magic link: - [`Redirect url`](#redirect-url) - [`Expiration time`](#expiration-time) - [`Route name`](#route-name) - [`Authentication guard`](#authentication-guard) - [`Logins limit`](#logins-limit) - [`Custom metadata`](#custom-metadata) #### Redirect url [](#redirect-url) You can provide a redirect url used after authenticating the user: ``` use App\Models\User; use Maize\MagicLogin\Facades\MagicLink; $user = User::firstOrFail(); $magicLink = MagicLink::send( authenticatable: $user, redirectUrl: 'yourapplication.test/your-path' ); ``` When not provided, the default value defined in `redirect_url` attribute under `config/magic-login.php` will be used. #### Expiration time [](#expiration-time) You can define the amount of time before a magic link expires by providing a carbon instance or an integer with the amount of minutes: ``` use App\Models\User; use Maize\MagicLogin\Facades\MagicLink; $user = User::firstOrFail(); $magicLink = MagicLink::send( authenticatable: $user, expiration: now()->addDays(10), // the link will expire in 10 days ); $magicLink = MagicLink::send( authenticatable: $user, expiration: 60, // the link will expire in 1 hour (60 minutes) ); ``` When not provided, the default value defined in `expiration` attribute under `config/magic-login.php` will be used. #### Route name [](#route-name) You can define the route name used to generate the magic link: ``` use App\Models\User; use Maize\MagicLogin\Facades\MagicLink; $user = User::firstOrFail(); $magicLink = MagicLink::send( authenticatable: $user, routeName: 'magic-link', ); ``` When not provided, the default value defined in `route.name` attribute under `config/magic-login.php` will be used. #### Authentication guard [](#authentication-guard) You can define the authentication guard used to authenticate the user: ``` use App\Models\User; use Maize\MagicLogin\Facades\MagicLink; $user = User::firstOrFail(); $magicLink = MagicLink::send( authenticatable: $user, guard: 'api' // the 'api' auth guard will be used ); ``` When not provided, the default value defined in `guard` attribute under `config/magic-login.php` will be used. #### Logins limit [](#logins-limit) You can define the amount of times a single link can be used before expiring. The value can be either -1, which lets the user login indefinitely, or any number greater than or equal to 1: ``` use App\Models\User; use Maize\MagicLogin\Facades\MagicLink; $user = User::firstOrFail(); $magicLink = MagicLink::send( authenticatable: $user, loginsLimit: 5 // the link can be used 5 times at max ); $magicLink = MagicLink::send( authenticatable: $user, loginsLimit: -1 // the link can be used an infinite amount of times ); ``` When not provided, the default value defined in `logins_limit` attribute under `config/magic-login.php` will be used. #### Custom metadata [](#custom-metadata) Optionally, you can store custom metadata in case you need to perform custom queries. ``` use App\Models\User; use Maize\MagicLogin\Facades\MagicLink; use Maize\MagicLogin\Models\MagicLogin; $user = User::firstOrFail(); $magicLink = MagicLink::send( authenticatable: $user, metadata: ['test' => true] ); MagicLogin::query() ->whereJsonContains('metadata->test', true) ->count(); // returns 1 MagicLogin::query() ->whereJsonContains('metadata->test', false) ->count(); // returns 0 ``` Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](https://github.com/maize-tech/.github/blob/main/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](https://github.com/maize-tech/.github/security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Enrico De Lazzari](https://github.com/enricodelazzari) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 52 — FairBetter than 96% of packages Maintenance72 Regular maintenance activity Popularity42 Moderate usage in the ecosystem Community19 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~92 days Recently: every ~192 days Total 11 Last Release 328d ago Major Versions 1.3.0 → 2.0.02023-02-27 ### Community Maintainers ![](https://www.gravatar.com/avatar/848d3feb1799fbdb3ff475a4398017f9bc2b94c5cba4dd69d414af62a856fcc4?d=identicon)[maize-tech](/maintainers/maize-tech) --- Top Contributors [![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (22 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (15 commits)")[![enricodelazzari](https://avatars.githubusercontent.com/u/10452445?v=4)](https://github.com/enricodelazzari "enricodelazzari (9 commits)")[![riccardodallavia](https://avatars.githubusercontent.com/u/1372062?v=4)](https://github.com/riccardodallavia "riccardodallavia (9 commits)")[![nathanjansen](https://avatars.githubusercontent.com/u/73473323?v=4)](https://github.com/nathanjansen "nathanjansen (1 commits)")[![trippo](https://avatars.githubusercontent.com/u/497169?v=4)](https://github.com/trippo "trippo (1 commits)") --- Tags authenticationlaravelloginmagic-authmagic-loginpasswordlesslaravelAuthenticationemailloginmagicmaize-tech ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/maize-tech-laravel-magic-login/health.svg) ``` [![Health](https://phpackages.com/badges/maize-tech-laravel-magic-login/health.svg)](https://phpackages.com/packages/maize-tech-laravel-magic-login) ``` ### Alternatives [tymon/jwt-auth JSON Web Token Authentication for Laravel and Lumen 11.5k49.1M350](/packages/tymon-jwt-auth)[php-open-source-saver/jwt-auth JSON Web Token Authentication for Laravel and Lumen 8359.8M53](/packages/php-open-source-saver-jwt-auth)[laragear/two-factor On-premises 2FA Authentication for out-of-the-box. 339785.3k8](/packages/laragear-two-factor)[auth0/login Auth0 Laravel SDK. Straight-forward and tested methods for implementing authentication, and accessing Auth0's Management API endpoints. 2745.0M3](/packages/auth0-login)[yadahan/laravel-authentication-log Laravel Authentication Log provides authentication logger and notification for Laravel. 416632.8k5](/packages/yadahan-laravel-authentication-log)[alajusticia/laravel-logins Session management in Laravel apps, user notifications on new access, support for multiple separate remember tokens, IP geolocation, User-Agent parser 2011.0k](/packages/alajusticia-laravel-logins) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)