hesystems/jwt

A simple and efficient JWT package for Laravel

dev-main 2025-08-23 10:06 UTC

Requires

• php: ^8.0
• illuminate/http: *
• illuminate/support: ^8.0|^9.0|^10.0|^11.0
• symfony/http-foundation: *

MIT

• HeSystems

README

Un package simple et léger permettant de générer et de valider des JSON Web Tokens (JWT) dans Laravel.

Installation

1. Ajout du package

Depuis GitHub

Dans le fichier composer.json du projet Laravel, ajouter :

"repositories": [
  {
    "type": "vcs",
    "url": "https://github.com/RomualdAKM/easy-jwt"
  }
]

Puis exécuter :

composer require hesystems/jwt:dev-main


Depuis un dossier local (développement)

"repositories": [
  {
    "type": "path",
    "url": "../hesystems-jwt"
  }
]


Puis exécuter :
composer require hesystems/jwt:dev-main


2. Publication de la configuration

Publier le fichier de configuration :

php artisan vendor:publish --tag=jwt-config


Définir ensuite la clé secrète dans .env :
JWT_SECRET=your_secret_key

Utilisation

Le package fournit une facade Jwt permettant de générer et de décoder des tokens.

Génération d’un token
use Jwt;

$token = Jwt::generate([
    'user_id' => 123,
    'role'    => 'admin',
]);

echo $token;
// eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...


Décodage d’un token
use Jwt;

$payload = Jwt::decode($token);

print_r($payload);
// [
//     "user_id" => 123,
//     "role" => "admin"
// ]


Gestion des erreurs

Une exception est levée si le token est invalide ou falsifié :
try {
    $payload = Jwt::decode($token);
} catch (\Exception $e) {
    echo "Erreur JWT : " . $e->getMessage();
}

Exemple d’intégration dans un contrôleur
namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Jwt;

class AuthController extends Controller
{
    public function login(Request $request)
    {
        // Exemple simplifié : utilisateur simulé
        $user = ['id' => 1, 'email' => '[e-mail]'];

        $token = Jwt::generate($user);

        return response()->json(['token' => $token]);
    }

    public function me(Request $request)
    {
        try {
            $payload = Jwt::decode($request->bearerToken());
            return response()->json($payload);
        } catch (\Exception $e) {
            return response()->json(['error' => 'Token invalide'], 401);
        }
    }
}