Cours Laravel 8 – les données – jouer avec Eloquent

On a commencé à voir Eloquent et les modèles dans le premier chapitre de cette partie du cours, mais on s’est limité pour le moment à créer un enregistrement. Dans ce chapitre on va aller plus loin en explorant les possibilités d’Eloquent, couplé à un puissant générateur de requêtes, pour manipuler les données.

Pour effectuer les manipulations de ce chapitre vous aurez besoin d’une installation fraîche de Laravel. Les migrations devront également être effectuées pour qu’on puisse utiliser la base de données.

Tinker

Artisan est plein de possibilités, l’une d’elle est un outil très pratique, un REPL (Read–Eval–Print Loop). C’est un outil qui permet d’entrer des expressions, de les faire évaluer et d’avoir le résultat à l’affichage et son nom est Tinker. Ce REPL est boosté par le package psys. Il y a un bon article de présentation en anglais ici.

Pour lancer cet outil il y a une commande d’artisan :

php artisan tinker

On va se servir de cet outil pour interagir avec la base de données dans ce chapitre.

Créer un enregistrement

Méthode create

On a déjà vu comment créer un enregistrement avec Eloquent. Comme a priori votre base de données est vide avec une installation fraiche de Laravel on va commencer par ajouter un utilisateur dans la table users à l’aide du modèle User. Pour mémoire ce modèle est le seul présent au départ :

Dans Tinker entrez cette expression :

User::create(['name' => 'Durand', 'email' => 'durand@chezlui.fr', 'password' => 'pass'])

Remarquez qu’on n’a pas besoin d’entrer l’espace de nom complet App\Models\User, Tinker crée automatiquement un alias.

La méthode create renvoie le modèle avec tous les attributs créés comme les dates et l’id. Tinker nous les affiche gentiment. On retrouve évidemment notre enregistrement dans la table users :

Pour mémoire cette méthode create est un assignement de masse et implique les précautions que nous avons déjà vues.

Méthode save

Une autre façon de créer un enregistrement avec Eloquent et de commencer par créer un modèle vide, renseigner les attributs, puis utiliser la méthode save pour enregistrer dans la table.

Entrez cette suite d’expressions :

$user = new User
$user->name = 'Dupont'
$user->email = 'dupont@chezlui.fr'
$user->password = 'pass'
$user->save()

On commence par créer le modèle, puis on renseigne ses attributs, enfin on enregistre dans la base avec save.

Modifier un enregistrement

Voyons maintenant comment modifier un enregistrement existant. Il y a aussi deux façons de procéder.

Méthode update

Entrez cette expression dans Tinker :

User::find(1)->update(['email' => 'durand@cheznous.fr'])

On commence par récupérer le premier enregistrement de la table avec find(1), ça a pour effet de créer un modèle avec les attributs renseignés pour Durand. Ensuite on utilise la méthode update sur ce modèle en précisant le nom et la valeur de chaque attribut qu’on veut modifier dans un tableau. ici on a changé l’adresse email pour Durand.

Avec cette méthode update on a encore le problème de l’assignement de masse.

Méthode save

On peut aussi utiliser la méthode save pour faire une modification. Entrez ces expressions dans Tinker :

$user = User::find(2)
$user->email = 'dupont@cheznous.fr'
$user->save()

Avec find(2) on crée un modèle avec les renseignements de Dupont (le deuxième enregistrement de la table), ensuite on change l’attribut email, enfin on enregistre dans la base.

On peut constater les modifications dans la table :

Remarquez que les colonnes created_at et updated_at n’ont maintenant plus les mêmes valeurs puisqu’on a fait des modifications.

Supprimer un enregistrement

Après la création et la modification vient tout naturellement la suppression avec la méthode delete. Si vous entrez cette expression dans Tinker :

User::find(2)->delete()

Vous supprimez l’utilisateur qui a l’index 2.

La suppression est définitive. Il existe aussi une possibilité de suppression provisoire (soft delete) mais il faut modifier le modèle en ajoutant un trait et une propriété. Cette partie de la documentation traite de ce sujet que je ne pense pas développer dans ce cours.

Trouver des enregistrements

Rafraichissez la table (pas dans Tinker cette fois) :

php artisan migrate:refresh

Et recréez avec Tinker les deux utilisateurs :

User::create(['name' => 'Durand', 'email' => 'durand@chezlui.fr', 'password' => 'pass']) 
User::create(['name' => 'Dupont', 'email' => 'dupont@chezlui.fr', 'password' => 'pass'])

Tous les enregistrements

On a vu déjà la méthode find pour trouver un enregistrement à partir de son identifiant (on peut aussi passer plusieurs identifiants dans un tableau). On peut aussi tous les récupérer avec la méthode all :

Si vous êtes observateur vous avez remarqué que cette fois on n’obtient pas un modèle, comme c’était le cas avec find mais une collection (Illuminate\Database\Eloquent\Collection). Cette classe comporte un nombre considérable de méthodes, on peut donc effectuer de nombreux traitement à ce niveau et même les chaîner.

Par exemple ici j’extrais un modèle au hasard de la collection :

J’aurai l’occasion dans ce cours de montrer l’utilisation de plusieurs des méthodes disponibles.

Sélectionner des enregistrements

En général on ne veut pas tous les enregistrements mais juste certains qui correspondent à certains critères. Eloquent est couplé à un puissant générateur de requêtes SQL (Query Builder). On peut par exemple utiliser la méthode where. Entrez cette expression dans Tinker :

User::where('name', 'Dupont')->get()

On récupère une collection qui ne contient que le modèle qui correspond à Dupont.

Ajoutez cet utilisateur :

User::create(['name' => 'Martin', 'email' => 'martin@chezlui.fr', 'password' => 'pass'])

On a maintenant 3 utilisateurs :

Maintenant entrez cette expression :

User::where('name', '<', 'e')->get()

Cette fois on a sélectionné à partir des noms dont la première lettre doit être avant « e » dans l’alphabet et on obtient une collection avec deux modèles.

On dispose de la méthode first si on veut récupérer juste le premier :

On peut aussi limiter les colonnes retournées avec la méthode select :

Ici on ne retourne que les noms.

Souvent on a envie de connaître la requête générée, pour la voir il suffit d’utiliser la méthode toSql :

On dispose avec le générateur de requête de riches possibilités que nous verrons progressivement, par exemple on peut facilement trier les enregistrements avec la méthode orderBy :

Souvent il existe un syntaxe plus simple, par exemple on peut obtenir le même résultat avec latest :

User::select('name')->latest('name')->get()

Trouver ou créer

Que se passe-t-il si l’enregistrement qu’on veut ne se trouve pas dans la table ? Faisons un essai :

On a null en retour et on peut gérer cette valeur. Mais des fois on se trouve dans une situation où on veut récupérer un enregistrement ou le créer s’il n’existe pas. On peut le faire en deux étapes mais on peut aussi le faire en une seule action avec la méthode firstOrCreate :

Ici comme l’enregistrement existe il est retourné normalement mais dans le cas suivant il n’existe pas et donc il est créé :

On se retrouve donc avec 4 enregistrements dans la table :

Il existe aussi la méthode firstOrNew, si l’enregistrement existe il est retourné comme avec firstOrCreate, par contre s’il n’existe pas il est juste créé une instance du modèle mais aucune action dans la base n’est réalisée.

De la même manière il existe la méthode updateOrCreate basée sur le même principe.

En résumé

• On peut créer des enregistrements avec Eloquent avec la méthode create.
• On peut modifier des enregistrements avec Eloquent avec la méthode update.
• On peut créer ou modifier des enregistrements avec Eloquent avec la méthode save.
• Le résultat d’une requête générée avec Eloquent est soit un modèle soit une collection.
• Eloquent est associé à un puissant générateur de requêtes (Query Builder).
• Des méthodes spéciales permettent de faire plusieurs actions comme aller chercher un enregistrement ou le créer s’il n’existe pas.