hans-thomas/sphinx

Json web token driver for laravel

v1.1.0 2023-08-17 11:05 UTC

This package is auto-updated.

Last update: 2024-04-24 18:31:49 UTC


README

sphinx Logo

codecov GitHub Workflow Status GitHub top language GitHub release (latest by date) StyleCi

Sphinx is a feature reach Jwt-based authentication system that make zero queries to database during authorization.

  • Customizable
  • Integration support with Horus
  • Based on Jwt
  • Two layers of encryption
  • Refresh token support
  • Logged-in users in one account limitation

Installation

Install the package via composer.

composer require hans-thomas/sphinx

Then, publish config file.

php artisan vendor:publish --tag sphinx-config

Setting up

Model

First, use Hans\Sphinx\Traits\SphinxTrait trait on your model and then implement the abstract methods. Next, inside your model, make sure to call the hooks method in your booted method.

use SphinxTrait, SphinxTrait {
    SphinxTrait::hooks as private sphinxHooks;
}

protected static function booted() {
    self::sphinxHooks();
}

Auth configuration

First of all, define the provider.

'providers' => [
    // ...
    'sphinxUsers' => [
        'driver' => 'sphinx',
        'model'  => App\Models\User::class,
    ],
    // ...
],

Then, add your guard.

'guards' => [
    // ...
    'jwt' => [
        'driver'   => 'sphinxJwt',
        'provider' => 'sphinxUsers',
    ],
    // ...
],

And finally, you can set the jwt guard as default.

'defaults' => [
    // ...
    'guard'     => 'jwt',
    // ...
],

All sets. enjoy!

Read more about Sphinx in documentation website.

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request ❤️

Support