Démarrage rapide#

Mettez en place le journal d'audit dans votre application Laravel en moins de 5 minutes.

Étape 1 : Choisissez votre mode#

AuditChain propose deux modes. Choisissez celui qui correspond à vos besoins :

Étape 2 : Ajoutez le trait#

Journal d'activité (mode léger)#

Journalisation d'activité simple sans vérification cryptographique :

use GrayMatter\AuditChain\Concerns\HasActivityLog;
use GrayMatter\AuditChain\Contracts\Auditable;

class Post extends Model implements Auditable
{
    use HasActivityLog;
}

Audit Trail (mode complet)#

Journal d'audit immutable avec chaîne de hash SHA-256 :

use GrayMatter\AuditChain\Concerns\HasAuditTrail;
use GrayMatter\AuditChain\Contracts\Auditable;

class Order extends Model implements Auditable
{
    use HasAuditTrail;
}

Étape 3 : Cela fonctionne automatiquement#

C'est tout. Tous les événements de création, modification et suppression sont désormais capturés automatiquement :

// All of these are automatically audited
$order = Order::create(['status' => 'pending', 'total' => 99.99]);
$order->update(['status' => 'shipped']);
$order->delete();

Étape 4 : Interrogez les logs d'audit#

Chaque model auditable dispose d'une relation auditLogs :

// Get all audit logs for this order
$order->auditLogs;

// Filter by event type
$order->auditLogs()->where('event', 'updated')->get();

Étape 5 : Vérifiez l'intégrité de la chaîne (mode complet)#

Si vous utilisez HasAuditTrail, vérifiez que personne n'a falsifié vos logs d'audit :

php artisan audit:verify

Et ensuite ?#

• Vérification de la chaîne — Automatiser les contrôles d'intégrité
• Événements personnalisés — Enregistrer des événements métier
• Regroupement par lot — Regrouper les opérations liées
• Annotation des données personnelles — Annoter les champs de données personnelles