Eloquent ORM

a. Initialisation d’un modèle

La méthode la plus simple pour créer un modèle est d’utiliser Artisan. Pour rappel, Artisan est l’outil mis à disposition par Laravel qui permet de lancer des commandes depuis un terminal. Pour créer une classe permettant de manipuler les articles du blog de jardinage http://mon-jardin.com, il faudra donc indiquer à Artisan de construire un modèle Article, chaque article étant un nouveau conseil sur le jardinage dans cet exemple. Utilisez pour cela la commande ci-dessous depuis le terminal.

Commande Artisan pour créer un modèle Article

sail artisan make:model Article  

Le modèle créé est ajouté dans le dossier app/Models de l’application Laravel. Il s’agit pour l’instant d’une classe sans méthodes ni propriétés propres qui hérite de la classe Model.

Structure d’une classe Article, classe App\Models\Article

<?php 
 
namespace App; 
 
use Illuminate\Database\Eloquent\Model; 
 
class Article extends Model 
{ 
    // 
}  

b. Modèles et migrations

Un modèle sans table associée est rarement suffisant. En effet, un modèle est fait pour enregistrer dans une base de données. Les articles du blog mon-jardin.com doivent ainsi être enregistrés pour pouvoir être réaffichés plus tard. Ils peuvent potentiellement être modifiés ou supprimés. Créer une migration permet de décrire la table associée à un modèle.

Il est possible de créer une migration en même temps que la création du modèle. Pour cela, ajoutez le paramètre --migration dans la commande...

a. Instancier un modèle

Une fois la classe de modèle générée et la table construite, créer une nouvelle instance d’un modèle se fait à l’aide du mot-clé new sur la classe, comme pour créer n’importe quel autre objet en PHP.

Création de trois instances d’utilisateurs

$user1 = new User; 
$user1->name = 'Colyne'; 
 
$user2 = new User; 
$user2->name = 'Arthur'; 
 
$user3 = new $user; 
$user3->name = 'Brian';  

Les instances d’un modèle peuvent être créées n’importe où dans le code : dans une méthode d’un contrôleur ou directement dans la fonction de rappel d’une route.

b. Enregistrement d’un modèle

Enregistrer un modèle se fait grâce à la fonction save disponible sur toutes les instances de modèles. Le mot-clé new crée une instance en mémoire pour la manipuler en PHP, tandis que la méthode save enregistre cette instance dans la base de données.

Enregistrement de trois instances d’utilisateurs

// Initialisation, définitions de propriétés 
$user1 = new User; 
$user1->name = 'Colyne'; 
 
$user2 = new User; 
$user2->name = 'Arthur'; 
 
$user3 = new $user; 
$user3->name = 'Brian'; 
 
// Enregistrement dans la base de données 
$user1->save(); 
$user2->save(); 
$user3->save();  

Lorsqu’un modèle est enregistré, cela signifie qu’il est enregistré dans une base de données. Il pourra donc y être retrouvé par la suite.

c. Créer et enregistrer un modèle en une ligne

Il est possible de créer et de sauvegarder un modèle directement dans la base de données en une seule instruction grâce à la méthode statique create disponible sur tous les modèles.

Création d’un utilisateur

User::create([ 
    'name' => 'Brian', 
    'email' => 'brian@example.com' 
]);  

Cette méthode retourne le modèle...

a. Création des modèles

Pour commencer, cette contrainte doit être codée dans la base de données puis indiquée dans les modèles. Créez d’abord les modèles et leurs migrations associées avec Artisan.

Création des modèles

php artisan make:model Company --migration 
 
php artisan make:model Address -migration  

b. Structure des tables

Ensuite, il faut...