Installation#

Prérequis#

• PHP >= 8.2
• Laravel 11 ou 12

Installation via Composer#

composer require graymatter/laravel-audit-chain

Publication de la configuration et de la migration#

Publiez le fichier de configuration et la migration :

php artisan vendor:publish --tag="audit-chain-config"
php artisan vendor:publish --tag="audit-chain-migrations"

Exécution des migrations#

php artisan migrate

Cette commande crée la table audit_logs avec toutes les colonnes nécessaires pour les modes journal d'activité et Audit Trail complet.

Configuration de l'environnement#

Pour une utilisation en production avec le mode Audit Trail, définissez un seed secret pour la chaîne dans votre fichier .env :

AUDIT_CHAIN_SEED=your-random-secret-value-here

Important : Le seed de la chaîne est utilisé pour calculer le hash de genèse — le premier maillon de la chaîne cryptographique. Un seed prévisible affaiblit les garanties de détection de falsification. Générez une valeur aléatoire avec php artisan tinker --execute="echo Str::random(64);".

Et ensuite ?#

Une fois l'installation terminée, consultez la page Configuration pour personnaliser le package, ou passez directement au Démarrage rapide pour le voir en action.