Introduction

Laravel fournit une façon facile et efficace de manipuler les données dans votre base de données grâce à Eloquent. Dans ce tutoriel, nous allons explorer les différentes méthodes que vous pouvez utiliser pour insérer, mettre à jour ou supprimer des enregistrements dans votre base de données.

Insérer des enregistrements

L’une des façons les plus communes d’insérer des enregistrements est d’utiliser la méthode create() de Eloquent. Cette méthode prend un tableau d’attributs comme argument et insère le(s) enregistrement(s) correspondant dans la base de données.

$contact = Contact::create([
    'name' => 'Keahi Hale',
    'email' => 'halek481@yahoo.com'
]);

La méthode create() sauvegarde automatiquement l’enregistrement dans la base de données, vous n’avez donc pas besoin d’appeler explicitement la méthode save().

Mettre à jour des enregistrements

Mettre à jour un enregistrement est également très simple avec Eloquent. Vous pouvez soit récupérer le(s) enregistrement(s) correspondant(s), modifier ses attributs et appeler ensuite la méthode save(), soit passer directement les attributs à mettre à jour à la méthode update().

// Méthode 1 : Récupérer l'enregistrement, modifier ses attributs et enregistrer
$contact = Contact::find(1);
$contact->email = 'natalie@parkfamily.com';
$contact->save();

// Méthode 2 : Passer les attributs à mettre à jour directement à la méthode update()
Contact::where('created_at', '<', now()->subYear())->update([
    'longevity' => 'ancient'
]);

Mass Assignment

Lorsque vous utilisez des tables d’enregistrements, il est important de comprendre comment Eloquent gère les attributs. En effet, si vous passez un tableau d’attributs à une méthode comme create() ou update(), tous les attributs spécifiés doivent être autorisés pour la masse affectation. Vous pouvez soit configurer explicitement les attributs pouvant être modifiés via la propriété $fillable de votre modèle, soit utiliser la notion de champs “protégés” ($guarded) pour interdire l’affectation de certains attributs.

// Configurer explicitement les attributs autorisés via $fillable
class Contact {
    protected $fillable = ['name', 'email'];
}

// Utiliser la notion de champs protégés ($guarded)
class Contact {
    protected $guarded = ['id', 'created_at', 'updated_at', 'owner_id'];
}

Request::only() avec Eloquent

Si vous utilisez le framework Laravel, vous pouvez utiliser la méthode only() du objet Request pour récupérer uniquement les attributs autorisés.

Contact::create($request->only('name', 'email'));

firstOrCreate() et firstOrNew()

Finalement, si vous souhaitez créer un enregistrement s’il n’existe pas déjà ou récupérer l’enregistrement existant si il existe déjà, vous pouvez utiliser les méthodes firstOrCreate() ou firstOrNew() de Eloquent.

$contact = Contact::firstOrCreate(['email' => 'luis.ramos@myacme.com']);

Suppression des enregistrements

La suppression d’un enregistrement est également très simple avec Eloquent. Vous pouvez soit appeler la méthode delete() sur l’enregistrement spécifique, soit utiliser la méthode destroy() pour supprimer plusieurs enregistrements à la fois.

// Suppression d'un enregistrement spécifique
$contact = Contact::find(1);
$contact->delete();

// Suppression de plusieurs enregistrements à la fois
Contact::destroy([1, 5, 7]);

En résumé, Eloquent offre une API facile et intuitive pour manipuler les données dans votre base de données. Les méthodes create(), update() et delete() permettent d’insérer, mettre à jour ou supprimer des enregistrements de manière simple, tandis que les concepts de masse affectation et de suppression “doublée” offrent une flexibilité supplémentaire pour gérer vos données.

Conclusion

Dans cet article, nous avons exploré les différentes façons d’utiliser Eloquent pour manipuler les données dans votre base de données. Nous avons vu comment insérer des enregistrements, mettre à jour ou supprimer des enregistrements, ainsi que comment gérer la masse affectation et la suppression “doublée”. Nous espérons que ce tutoriel vous aura été utile pour mieux comprendre les fonctionnalités de Eloquent et pour vous aider dans vos projets Laravel.