README

Module de gestion des utilisateurs pour NilsFramework.
Inscription, connexion, profil, CRUD complet — prêt à l'emploi.

📋 Table des matières

• Installation
• Migration SQL
• Configuration
• Routes disponibles
• Utilisation
• Étendre le modèle

Installation

composer require nilsframework/nils-users

Migration SQL

mysql -u root -p ma_base < vendor/nilsframework/nils-users/migrations/users_table.sql

Crée la table nils_users :

Configuration

Copiez UserController.php dans votre dossier controllers/ :

cp vendor/nilsframework/nils-users/src/UserController.php controllers/

Routes disponibles

Auth

Utilisateurs

Utilisation

Inscription

POST /auth/register
Content-Type: application/json

{
    "nom": "Traore Nils",
    "email": "nils@example.com",
    "password": "monmotdepasse",
    "password_confirmation": "monmotdepasse"
}

{
    "success": true,
    "message": "Compte créé avec succès.",
    "utilisateur": { "id": 1, "nom": "Traore Nils", "email": "nils@example.com" },
    "token": "eyJhbGci...",
    "refresh_token": "eyJhbGci..."
}

Connexion

POST /auth/login
Content-Type: application/json

{
    "email": "nils@example.com",
    "password": "monmotdepasse"
}

{
    "success": true,
    "message": "Connexion réussie.",
    "donnees": {
        "utilisateur": { "id": 1, "nom": "Traore Nils", "email": "nils@example.com" },
        "token": "eyJhbGci...",
        "refresh_token": "eyJhbGci..."
    }
}

Profil connecté

GET /auth/me
Authorization: Bearer eyJhbGci...

Modifier son profil

PATCH /auth/me
Authorization: Bearer eyJhbGci...
Content-Type: application/json

{
    "nom": "Nouveau nom",
    "email": "nouveau@email.com"
}

Rafraîchir le token

POST /auth/refresh
Content-Type: application/json

{
    "refresh_token": "eyJhbGci..."
}

Déconnexion

POST /auth/logout
Authorization: Bearer eyJhbGci...

Étendre le modèle

namespace modeles;

use NilsUsers\Modeles\User;

class MonUser extends User
{
    // Changer la table
    protected static string $table = 'mes_utilisateurs';

    // Ajouter des champs au schema
    protected static array $schema = [
        ...User::BASE_SCHEMA,
        'telephone' => [
            'type'     => 'string',
            'required' => false,
            'max'      => 20,
        ],
        'adresse' => [
            'type'     => 'string',
            'required' => false,
        ],
    ];

    // Masquer des champs supplémentaires
    protected static array $hidden = ['password', 'actif'];
}

Licence

MIT — © NilsFramework