Eloquent les modèles simplement

Sommaires

Dans ce TP nous allons voir comment générer le modèle Laravel à partir d'une base de données existante.

Introduction

Pour pouvoir utiliser Laravel, nous allons avoir besoin de différents outils :

PHP 8
Composer

Il y a bien plus de dépendances, mais celles-ci seront récupérées automatiquement par Composer

Créer le projet

Votre poste est maintenant configuré pour Laravel, vous pouvez donc créer un nouveau projet grâce à la commande :

✋ Attention, le projet sera créé dans le dossier courant.

bash

composer create-project --prefer-dist laravel/laravel generation-de-modele

La commande va télécharger l'ensemble des dépendances nécessaire et va créer un dossier generation-de-modele avec les sources.

Vous avez récupéré le projet via GIT ?

Si vous avez récupéré le projet depuis GIT vous n'allez bien évidemment pas utiliser la commande create-project… Par contre vous allez devoir réinstaller les dépendances (vendor) de votre projet. C'est très simple :

Dans le dossier de votre projet, lancer la commande :

composer install

Initialisation

Votre nouveau projet contient un fichier .env ouvrez-le, et éditez par exemple le nom du projet.

Questions :

Le fichier est plutôt complet, à quoi servent les différents paramètres ?
Dans les cours, je vous ai parlé de la APP_KEY, celle-ci est déjà remplie, à votre avis pourquoi ?

Lancer le projet d’exemple

Laravel intègre un serveur de test permettant de valider son développement avec rien d’autre que PHP sur sa machine. Pour ça, dans le dossier du projet (cd mon-premier-projet) vous pouvez faire la commande suivante :

bash

php artisan serve

Rendez-vous maintenant dans votre navigateur pour voir le site de démonstration fourni par Laravel.

Sample Laravel

La base de données

L'idée de ce TP est de générer automatiquement les modèles à partir de la structure de votre base de données.

Pourquoi générer nos modèles ? L'avantage de générer nos modèles c'est qu'ils vont vraiment être complets.

Ils contiendront évidemment les, $fillable mais également les jointures entre les tables !

Importer la BDD

Dans un premier temps, je vous laisse restaurer la base suivante :

Télécharger la base de données

Aperçu de la bdd

Je vous laisse importer la base de données dans MySQL.

Installer le générateur de modèle

Pour générer les modèles, nous allons utiliser un plugin que nous allons ajouter avec Composer.

Le plugin en question Reliese Laravel Model Generator

Pour l'installer, la procédure est simple :

composer require reliese/laravel --dev
php artisan vendor:publish --tag=reliese-models
php artisan config:clear

Un instant !

Qu'avez-vous installé ? Quels fichiers ont été modifiés ? Je vous laisse regarder, nous allons en parler !

Générer les modèles

Attention

Avant de générer les modèles, je vous laisse vérifier la configuration de votre .env notamment au niveau de la base de données.

Maintenant que votre base de données est configurée et prête à être utilisée depuis Laravel, nous allons pouvoir générer l'ensemble des modèles de notre application.

Pour générer l'ensemble des modèles, nous allons saisir une nouvelle commande (celle-ci a été ajoutée par le plugin que vous venez d'ajouter) :

php artisan code:models

C'est rapide et ça fonctionne !

En quelques secondes le plugin a créé l'ensemble des modèles de votre projet. Je vous laisser regarder les modifications dans votre projet, et surtout le dossier models

Les modèles générés

Avant d'aller plus loin, regardons ensemble un peu les modèles :

Les modèles

Vous vous souvenez des jointures ? Je vous avais expliqué qu'il était possible de les définir dans Laravel pour requêter simplement votre base de données. Dans le code généré par le plugins, nous avons évidemment celle-ci, voilà un exemple :

Les modèles

STOP

Ici, pas de magie ! Le plugin ne fait qu'écrire du code à votre place. Le code vous ne pouvez évidemment pas l'inventer, il est dans la documentation officielle de Laravel.

Vous l'avez oublié ? Pas de problème :

La documentation de base Les jointures et Eloquent

Testons avec la liste des commandes

Pour voir l'intérêt de tout ceci, nous allons réaliser quelques requêtes !

Pour ça nous allons ajouter quelques éléments dans votre projet… En premier lieu, un contrôleur qui permettra de réaliser les requêtes.

Pour tester, nous allons réaliser des requêtes dans la table orders.

Pour cette première fois, nous allons le faire ensemble.

1. Ajouter un contrôleur

La première étape, c'est la création du contrôleur :

php artisan make:controller OrdersController

2. Déclarer la route

php

Route::get('/orders', [OrdersController::class, 'list']);

Un instant ✋

En PHP objet il y a la notion de namespace, Laravel utilise de base les namespace, ça veut dire que nous allons avoir à utiliser le mot clé use pour importer (include). Quand vous voulez utiliser une classe qui n'est pas dans le même fichier, il faudra déclarer l'emplacement via un use. Exemple, pour que la classe Demo soit accessible depuis une autre classe, il faudra :

php

use App\Models\Demo;

⚠️ Si vous utilisez PHPStorm, cet import sera automatique.
⚠️ Si vous utilisez VSCode, il faudra passer par une extension Disponible ici

Pour PHPStorm, alt+entrée permettra de déclencher l'ajout dû use.

Pour VSCode je vous laisse regarder l'usage de l'extension :

Namespace Resolver

3. Déclarer la méthode

Si vous avez bien suivi, vous avez compris que nous allons devoir ajouter dans notre OrdersController une méthode list.

Dans votre contrôleur, ajouter le code suivant :

php

    function list(){
        return view("orders-list", ["orders" => Order::all()]);
    }

Un instant !

Qu'avez-vous copié / coller ?

Order::all() ? À quoi correspond cette ligne ?
orders-list ? Avez-vous créé ce fichier ?

4. Créer la vue

Vous l'avez vu, nous avons besoin d'un template pour que la page s'affiche. Créer un fichier nommé orders-list.blade.php dans le dossier. resources/view

html

<!DOCTYPE html>
<html lang="fr">
    <head>
        <meta charset="UTF-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0/css/bootstrap.min.css" integrity="sha384-Gn5384xqQ1aoWXA+058RXPxPg6fy4IWvTNh0E263XmFcJlSAwiGgFAW/dAiS6JXm" crossorigin="anonymous">
    </head>
    <body>
        <div>
            <div>
                <table class="table">
                    <thead>
                        <tr>
                            <td>Numéro de commande</td>
                            <td>Status</td>
                            <td>Client</td>
                            <td>#</td>
                        </tr>
                    </thead>
                    <tbody class="bg-white dark:bg-slate-800">
                    @foreach($orders as $order)
                        <tr>
                            <td>{{$order->orderNumber}}</td>
                            <td>{{$order->status}}</td>
                            <td>{{$order->customer->contactFirstName}} {{$order->customer->contactLastName}}</td>
                            <td>
                                <a class="btn btn-primary" href="/orders/{{$order->orderNumber}}">Voir la page de détail</a>
                            </td>
                        </tr>    
                    @endforeach
                    </tbody>
                </table>
            </div>
        </div>
    </body>
</html>

Je vous laisse tester dans votre navigateur, si tout fonctionne correctement vous devriez avoir :

Exemple de résultat

Un instant !

Vous avez remarqué ? Non ? Vraiment ?
Vous avez des données de commande, mais vous avez également des données client (customer) ! Comment est-ce possible ? Vous n'avez pas écrit de requête pourtant ?
$order->customer est en fait un raccourci qui va faire la requête pour vous !
- Attention… pas de magie… Le code est écrit dans la méthode customer() du modèle Order.
- Avant d'aller plus loin, allez regarder le code du modèle.

5. Ajouter une autre donnée

Vu que vous avez regardé le modèle Order, vous avez remarqué la méthode orderdetails. Je vous laisse :

Ajouter dans les données une nouvelle colonne dans le tableau.
Celle-ci doit contenir le nombre de produits commandés.

Un indice

html

({{sizeof($order->orderdetails)}})

C'est à vous !

Ajouter la vue de détail

Nous allons maintenant faire la page de détail en prenant le même principe.

1. La méthode

Pour vous aider, voilà le code. Attention avant de copier / coller trop rapidement, regardez bien…

php

function detail($id){
    return view("orders-detail", ["order" => Order::find($id)]);
}

Un instant !

D'où ça provient $id ?
::find($id) ? À quoi sert cette méthode ?

2. La route

Et pour assembler le tout… La route !

php

Route::get('/orders/{id}', [OrdersController::class, 'detail']);

{id} ? Correspond à une route dynamique, grâce à cette notation, votre variable $id de votre contrôleur sera automatiquement remplie avec la valeur en provenance du lien.

3. Le template

Je vous laisse l'écrire, celui-ci va afficher (de manière sympa, dans une Card) :

La commande
Le client
Le détail de la commande (liste des produit)

Vous pouvez débuter avec…

html

<h2>Commande</h2>
{{ $order }}

<h2>Client</h2>
{{ $order->customer }}

<h2>Détail</h2>
{{ $order->orderdetails }}

Ce n’est pas beau, mais ça fonctionne :

C'est moche, mais ça fonctionne

Créer une commande

Nous avons traité la lecture, maintenant nous allons voir comment créer une commande. Pour ça, nous allons devoir :

Créer une route pour traiter le formulaire.
Créer un formulaire pour saisir les informations de la commande.
Créer une méthode dans le contrôleur pour traiter le formulaire.

1. Créer la route

Pour notre système, nous allons créer une route qui va permettre d'afficher le formulaire, et une autre qui va permettre de traiter le formulaire.

php

Route::get('/orders/create', [OrdersController::class, 'createForm']);
Route::post('/orders/create', [OrdersController::class, 'create']);

Un instant !

Pourquoi deux routes ?
Pourquoi une route get et une route post ?

2. Créer le formulaire

Pour créer le formulaire, rien de nouveau, nous allons utiliser comme d'habitude du HTML.

html

<form action="/orders/create" method="post">
    @csrf
    <div>
        <label for="orderNumber">Numéro de commande</label>
        <input type="text" name="orderNumber" id="orderNumber">
    </div>
    <div>
        <!-- Vous pouvez ajouter ici un select pour les status -->
    </div>
    <div>
        <label for="comments">Commentaires</label>
        <textarea name="comments" id="comments" cols="30" rows="10"></textarea>
    </div>
    <div>
        <label for="customerNumber">Numéro de client</label>
        <select name="customerNumber" id="customerNumber">
            @foreach($customers as $customer)
                <option value="{{$customer->customerNumber}}">{{$customer->contactLastName}} {{$customer->contactFirstName}}</option>
            @endforeach
        </select>
    </div>
    <div>
        <input type="submit" value="Créer la commande">
    </div>
</form>

Quelques explications :

@csrf ? C'est une protection de Laravel, il faut toujours l'ajouter dans les formulaires.
@foreach($customers as $customer) ? Vous avez vu ? Nous avons une variable $customers qui contient l'ensemble des clients. Comment est-ce possible ? Vous n'avez pas écrit de requête ? C'est le modèle Customer qui va faire la requête pour vous !

3. Créer la méthode affichant le formulaire

Pour afficher le formulaire, nous allons devoir créer une méthode dans le contrôleur.

php

function createForm(){
    return view("orders-create", ["customers" => Customer::all()]);
}

Customer::all() va permettre de récupérer l'ensemble des clients. La variable $customers sera donc disponible dans le template pour afficher la liste des clients.

4. Créer la méthode traitant le formulaire

Pour traiter le formulaire, nous allons devoir créer une méthode dans le contrôleur.

php

function create(Request $request){
    $order = new Order();
    $order->orderNumber = $request->input("orderNumber");
    $order->status = $request->input("status");
    $order->comments = $request->input("comments");
    $order->customerNumber = $request->input("customerNumber");
    $order->save();
    return redirect("/orders");
}

C'est à vous ! Je vous laisse assembler le code pour créer une commande.

N'oubliez pas !

Nous créons une nouvelle commande, mais nous n'avons pas de vérification sur les données. Vous pouvez ajouter des vérifications sur les données, par exemple :

Vérifier que le numéro de commande n'existe pas déjà.
Vérifier que le client existe.
Vérifier que le status est bien un status valide.

La pagination

Temps estimé : 5 minutes (et oui, c'est rapide !)

Vous l'avez certainement remarqué, la liste des commandes est assez longue. Pour l'instant aucun problème, mais si nous avions 1 million de commandes, ça serait un peu plus compliqué.

Réaliser une pagination avec Laravel est très simple, il suffit de remplacer la méthode all par la méthode paginate.

Dans la méthode list du contrôleur OrdersController :

php

function list(){
    return view("orders-list", ["orders" => Order::paginate(10)]);
}

Notez la différence

Order::all() ? Récupère l'ensemble des commandes.
Order::paginate(10) ? Récupère les 10 premières commandes.

Et c'est tout ! Laravel va automatiquement ajouter les liens de pagination dans votre template.

Vous pouvez tester en ajoutant un paramètre page dans l'URL. Exemple : http://localhost:8000/orders?page=2

Et là vous allez me dire… Mais ok, je dois quand même écrire du code pour afficher les liens de pagination ? Et bien non ! Laravel nous fournit des méthodes pour afficher les liens de pagination.

Dans le template orders-list.blade.php :

html

{{ $orders->links() }}

Pagination

Nous touchons du doigt l'un des avantage d'un framework (ici Laravel). Si vous aviez dû écrire le code pour gérer la pagination, vous auriez passé du temps à écire un code assez complexe. Ici, en une ligne, vous avez la pagination. C'est l'intérêt de la standardisation, et de l'uniformisation du code.

La personnalisation c'est possible !

Le style proposé utilise TailWind, mais il est également possible de gérer les liens de pagination manuellement, pour ça :

html

<div>
    <a href="{{ $orders->previousPageUrl() }}">Précédent</a>
    <a href="{{ $orders->nextPageUrl() }}">Suivant</a>
</div>

Laravel propose également d'autres méthodes pour gérer la pagination :

Documentation Laravel

Créer un paiement pour le client

Avec le système de relation entre les tables, il est possible d'intéragir uniquement avec un modèle pour réaliser des actions sur plusieurs tables. Par exemple créer un paiement pour un client.

Voici un exemple :

php

// Récupérer le client 103
$customer = Customer::find(103);

// Création d'un nouveau payments
$payment = new Payment();
$payment->checkNumber = '123456';
$payment->paymentDate = '2004-10-19';
$payment->amount = 14571.44;

// Ajouter le nouveau paiement au client 103
$customer->payments()->save($payment);

Dans cet exemple, nous avons créé un nouveau paiement pour le client 103. La méthode save va automatiquement ajouter le paiement au client.

C'est à vous !

Je vous laisse modifier votre formulaire de création de commande pour y ajouter les éléments nécessaire pour y joindre un paiement

Rappel sur les relations avec `Sync` et `Attach`

Avec Laravel, il est possible de gérer les relations entre les tables de manière très simple. Pour ça, Laravel propose deux méthodes :

attach : Permet d'ajouter une relation entre deux tables.
sync : Permet de synchroniser les relations entre deux tables.

Nous allons modifier notre base de données pour créer un système de catégorie de client (en respectant les règles de nommage de Laravel) :

Créer une nouvelle table categories.
Créer une nouvelle table pivot category_customer.
Créer les relations entre les tables.
Un client peut avoir plusieurs catégories.

sql

-- Création de la table categories
CREATE TABLE categories (
    id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
    name VARCHAR(255) NOT NULL,
    description TEXT,
    created_at TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    PRIMARY KEY (id)
);

-- Création de la table pivot category_customer
CREATE TABLE category_customer (
    customerNumber INT NOT NULL,
    category_id BIGINT UNSIGNED NOT NULL,
    created_at TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    PRIMARY KEY (customerNumber, category_id),
    FOREIGN KEY (customerNumber) REFERENCES customers(customerNumber) ON DELETE CASCADE,
    FOREIGN KEY (category_id) REFERENCES categories(id) ON DELETE CASCADE,
    INDEX category_customer_customer_number_index (customerNumber),
    INDEX category_customer_category_id_index (category_id)
);

-- Insertion des données dans la table categories
INSERT INTO categories (name, description) VALUES
('Premium', 'Clients premium avec avantages spéciaux'),
('Standard', 'Clients standards'),
('Business', 'Clients professionnels'),
('VIP', 'Clients très importants'),
('Nouveau', 'Nouveaux clients'),
('Inactif', 'Clients inactifs depuis plus de 6 mois');

1. Régénérer les modèles

Maintenant que nous avons modifié la base de données, nous allons devoir régénérer les modèles.

php artisan code:models --table=categories
php artisan code:models --table=category_customer
php artisan code:models --table=customers

Je vous laisse regarder les modèles générés, vous avez maintenant un modèle Category et un modèle CustomerCategory.

Le modèle Customer a également été mis à jour pour prendre en compte la nouvelle relation. Il est intéressant de regarder le code généré :

php

// NE PAS COPIER COLLER
// Exemple de code généré
// NE PAS COPIER COLLER
public function categories()
{
return $this->belongsToMany(Category::class, 'category_customer', 'customerNumber')
    ->withTimestamps();
}
// NE PAS COPIER COLLER

Quelques explications :

belongsToMany ? C'est la méthode qui permet de définir une relation de type many to many (plusieurs à plusieurs). Ici, un client peut avoir plusieurs catégories.
Category::class ? C'est la classe du modèle Category.
'category_customer' ? C'est le nom de la table pivot.
'customerNumber' ? C'est la clé étrangère de la table customers.
->withTimestamps() ? C'est une option qui va ajouter les champs created_at et updated_at dans la table pivot. Utile pour garder une trace des modifications.

L'importance du nommage

Quand vous écrivez vos modèles manuellement, aucun problème, vous pouvez les nommer comme vous le souhaitez.

Cependant, si vous utilisez le plugin de génération de modèle, il est important de respecter les règles de nommage de Laravel. Pour que celui-ci puisse générer les relations correctement, vos tables doivent respecter :

Le nom de la table doit être au pluriel.
Le nom de la table pivot doit être composé des noms des tables en ordre alphabétique et au singulier.

Sinon, il faut écrire les relations manuellement :

php

public function categories()
{
    return $this->belongsToMany(Category::class, 'category_customer', 'customerNumber')
        ->withTimestamps();
}

2. Associer une catégorie à un client

Maintenant que nous avons créé les tables, nous allons pouvoir associer des catégories à des clients. Pour cela plusieurs options sont possibles :

sync : Permet de synchroniser les relations entre deux tables. Cela va supprimer les relations existantes et ajouter les nouvelles.
attach : Permet d'ajouter une relation entre deux tables. Cela va ajouter une nouvelle relation. Sans supprimer les relations existantes.

Pour ajouter une catégorie à un client, nous allons utiliser la méthode attach :

php

// Récupérer le client 103
$customer = Customer::find(103);

// Ajouter la catégorie au client
$customer->categories()->attach([1, 2]);

Si à la place de attach vous utilisez sync, vous allez supprimer les relations existantes et ajouter la nouvelle relation.

php

// Récupérer le client 103
$customer = Customer::find(103);

// Ajouter la catégorie au client
$customer->categories()->sync([3, 4]);

Pour supprimer une relation, vous pouvez utiliser la méthode detach :

php

// Récupérer le client 103
$customer = Customer::find(103);

// Supprimer la catégorie du client
$customer->categories()->detach(1);

C'est à vous !

Pour l'instant notre application ne gère pas les customer, nous allons donc simplement créer une route pour tester cette nouvelle fonctionnalité.

php

Route::get('/customers/{id}/categories', [CustomersController::class, 'categories']);

Je vous laisse tester les différentes méthodes (sync, attach, detach) en regardant le résultat dans votre base de données. Exemple avec un sync :

Sync

Et si nous allions plus loin

Notre base de données est assez volumineuse et permet de faire bien plus ! Je vous laisse créer les routes et la vue permettant de consulter un Customer :

Liste des Customer.
Vue de détail d'un Customer.
- Le détail du Customer.
- Dans la vue de détail, je veux voir la liste des commandes du Customer.

Pour ça vous allez devoir :

Créer un nouveau contrôleur.
Les routes

Un Instant !

Pour réaliser les deux pages, vous n'avez besoin que d'un seul modèle (Customer). Via les jointures l'ensemble des autres requêtes sera automatique !

Exemple dans le PHP:

php


// Récupérer le client 1
$customer = Customer::find(1);

// Récupérer les commandes du client
$customer->orders;

// Récupérer les commandes du client avec le détail
$customer->orders->orderdetails;

// Récupérer les commandes du client avec le détail et le produit
$customer->orders->orderdetails->product;

// Récupérer les catégories du client
$customer->categories;

Ou depuis un template blade :

html

{{ $customer->orders }}
{{ $customer->orders->orderdetails }}
{{ $customer->orders->orderdetails->product }}
{{ $customer->categories }}

La variable $customer est un objet de type Customer, celui-ci contient les méthodes orders et ordersdetails qui vont faire les requêtes pour vous !

C'est à vous !

Évolution de la base de données

Actuellement notre customers ne peux avoir qu'une seule adresse, nous allons modifier la base de données pour que celui-ci puisse avoir plusieurs adresses.

Pour ça, nous allons devoir modifier la table customers et créer une nouvelle table addresses.

1. Modifier la table `customers`

Pour modifier la table customers nous allons devoir retirer la colonne relative à l'adresse et ajouter une colonne address_id.

sql

ALTER TABLE `customers` DROP COLUMN `addressLine1`;
ALTER TABLE `customers` DROP COLUMN `addressLine2`;
ALTER TABLE `customers` DROP COLUMN `city`;
ALTER TABLE `customers` DROP COLUMN `state`;
ALTER TABLE `customers` DROP COLUMN `postalCode`;
ALTER TABLE `customers` DROP COLUMN `country`;

2. Créer la table `addresses`

Pour créer la table addresses nous allons devoir créer une nouvelle table.

sql

CREATE TABLE `addresses` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `addressLine1` varchar(50) DEFAULT NULL,
  `addressLine2` varchar(50) DEFAULT NULL,
  `city` varchar(50) DEFAULT NULL,
  `state` varchar(50) DEFAULT NULL,
  `postalCode` varchar(15) DEFAULT NULL,
  `country` varchar(50) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=latin1;

3. Ajouter la relation

Maintenant que nous avons créé la table addresses, nous allons devoir ajouter la relation entre customers et addresses. Pour ça, nous allons ajouter une autre table customers_addresses.

sql

CREATE TABLE `customers_addresses` (
  `customerNumber` int(11) NOT NULL,
  `address_id` int(11) NOT NULL,
  PRIMARY KEY (`customerNumber`,`address_id`),
  KEY `customers_addresses_address_id_foreign` (`address_id`),
  CONSTRAINT `customers_addresses_address_id_foreign` FOREIGN KEY (`address_id`) REFERENCES `addresses` (`id`),
  CONSTRAINT `customers_addresses_customer_number_foreign` FOREIGN KEY (`customerNumber`) REFERENCES `customers` (`customerNumber`)
) ENGINE=InnoDB DEFAULT CHARSET=latin1;

Cette table va permettre de faire la relation entre customers et addresses, l'objectif est de pouvoir ajouter plusieurs adresses à un client.

3. Regénération des modèles

Notre base de données a changé, nous allons devoir régénérer les modèles.

php artisan code:models --table=customers
php artisan code:models --table=addresses
php artisan code:models --table=customers_addresses

Ces trois commandes vont permettre de régénérer le modèle Customer et générer le modèle Address.

4. Corriger votre précédente vue

Vous avez créé une vue permettant de voir le détail d'un Customer, celle-ci ne fonctionne plus, il va falloir la corriger pour afficher une liste d'adresse.

Comment faire ?

Vous avez un modèle Customer qui contient une méthode addresses. Vous pouvez donc écrire dans votre template :

Ici, nous allons parcourir les adresses du client et les afficher :

html

@forelse ($customer->addresses as $address)
    <div>
        <div>{{$address->addressLine1}}</div>
        <div>{{$address->addressLine2}}</div>
        <div>{{$address->city}}, {{$address->postalCode}}, {{ $address->state }} , {{$address->country}}</div>
    </div>
@empty
    <div>Aucune adresse</div>
@endforelse

Un peu de lecture :

@forelse: C'est une boucle, si la liste est vide, le code dans le bloc @empty sera exécuté.
$address : C'est l'adresse en cours de traitement dans la boucle.

5. Créer une nouvelle adresse

Maintenant que nous avons corrigé la vue, nous allons pouvoir créer une nouvelle adresse pour un client. Pour ça nous allons créer deux nouvelles routes :

php

Route::get('/customers/{id}/addresses/create', [CustomersController::class, 'createAddressForm']);
Route::post('/customers/{id}/addresses/create', [CustomersController::class, 'createAddress']);

Puis les méthodes dans le contrôleur :

php

function createAddressForm($id){
    return view("customers-create-address", ["customer" => Customer::find($id)]);
}

function createAddress(Request $request, $id){
    // Création de l'adresse
    $address = new Address();
    $address->addressLine1 = $request->input("addressLine1");
    $address->addressLine2 = $request->input("addressLine2");
    $address->city = $request->input("city");
    $address->state = $request->input("state");
    $address->postalCode = $request->input("postalCode");
    $address->country = $request->input("country");
    $address->save();

    // Ajout de l'adresse au client
    $customer = Customer::find($id);

    // La méthode attach permet d'ajouter une relation entre deux tables. Elle va ajouter une ligne dans la table de relation.
    $customer->addresses()->attach($address);
    
    // Redirection vers la page de détail du client
    return redirect("/customers/$id");
}

Et enfin le template :

html

<form action="/customers/{{$customer->id}}/addresses/create" method="post">
    @csrf
    <!-- Je vous laisse écrire l'interieur du formulaire -->
</form>

@csrf ? C'est une protection anti-rejeu de Laravel, il faut toujours l'ajouter dans les formulaires.
{{$customer->id}} ? C'est l'identifiant du client, il est nécessaire pour ajouter l'adresse au client.

C'est à vous !

Je vous laisse assembler le code pour créer de nouvelle adresse pour un client.

6. Afficher un message de succès

Avec Laravel il est très simple d'afficher un message de succès, pour ça nous allons utiliser la méthode with de l'objet RedirectResponse.

Modifier la méthode createAddress pour remplacer le return par le code suivant :

php

return redirect("/customers/$id")->with("success", "L'adresse a bien été ajoutée");

Puis dans le template de la vue de détail, ajouter le code suivant :

html

@if (session('success'))
    <div class="alert alert-success">
        {{ session('success') }}
    </div>
@endif

Comment ça fonctionne ?

session('success') ? C'est une variable de session, elle est disponible dans tous les templates.
{{ session('success') }} ? C'est la valeur de la variable de session success.
with("success", "L'adresse a bien été ajoutée") ? C'est la méthode with qui va ajouter une variable de session success avec la valeur L'adresse a bien été ajoutée.

L'avantage ? Les variables de session ajoutées avec with seront automatiquement supprimées après la première lecture. Pratique !

7. Supprimer une adresse

Maintenant que vous avez compris le principe. Je vous laisse créer le code pour supprimer une adresse. Pour vous aider dans la démarche, voilà les étapes :

Créer une nouvelle route customers/{id}/addresses/{addressId}/delete.
Créer une nouvelle méthode dans le contrôleur deleteAddress.
Le code doit trouver l'adresse en base de données et la supprimer. (find et delete).
Le code doit rediriger vers la page de détail du client avec un message de succès ou d'erreur.

N'oubliez pas, pour vous aider, vous avez l'aide mémoire :

Créer un nouveau client

Je vous laisse maintenant créer un formulaire pour ajouter un nouveau client. N'oubliez pas de vous inspirer du code existant.

Petite contrainte de ma part, le formulaire doit également permettre de sélectionner une ou plusieurs catégories pour le client.

Un instant !

Pour la partie catégorie, n'oubliez pas vos tests précédent. Vous avez déjà testé les relations sync, attach et detach. Vous pouvez les réutiliser pour ajouter des catégories à un client.

Modifier un client

Maintenant que vous avez créé un formulaire pour ajouter un client, je vous laisse créer un formulaire pour modifier un client. N'oubliez pas de vous inspirer du code existant.

Petite contrainte de ma part, le formulaire doit également permettre de sélectionner une ou plusieurs catégories pour le client.

Un instant !

Aller plus loin

Déjà au bout ? Vous souhaitez un peu de challenge ? Je vous laisse aller plus loin :

Ajouter des rôles aux clients :

Créer une nouvelle table roles.
Créer une nouvelle table customers_roles.
Créer les relations entre les tables.

Réexporter les modèles :

php artisan code:models --table=customers
php artisan code:models --table=custmers_roles
php artisan code:models --table=roles

Ajouter une page permettant de modifier les rôles d'un client (vous pouvez utiliser sync sur la relation roles du modèle Customer). Comment faire ?

Vous avez un modèle Customer qui contient une méthode roles. Vous pouvez donc écrire dans votre méthode de modification des rôles:

php

// Get roles from post
$roles = $request->input("roles"); // <- Tableau contenant les identifiants des rôles à ajouter [1, 2, 3]
Customer::find(1)->roles()->sync($roles);

Une astuce pour récupérer directement votre Customer depuis une route du routeur ?

Si vous avez besoin de récupérer votre Customer depuis une route du routeur, vous pouvez utiliser le code suivant :

La route :

php

Route::get('/customers/{customer}/edit-roles', [CustomersController::class, 'editRolesForm']);

La méthode :

php

function editRolesForm(Customer $customer){
    return view("customers-edit-roles", ["customer" => $customer, "roles" => Role::all()]);
}

En utilisant le type Customer dans la route, Laravel va automatiquement récupérer le client depuis la base de données et le passer en paramètre de la méthode. La récupération du Customer est réalisée grâce à son identifiant et la méthode find.

Et dans votre template :

html

<!-- Select multiple avec reselect des valeurs précédement choisi pour les roles du client -->
<select name="roles[]" id="roles" multiple>
    @foreach($roles as $role)
        <option value="{{$role->id}}" @if($customer->roles->contains($role->id)) selected @endif>{{$role->name}}</option>
    @endforeach
</select>

L'astuce

L'astuce ici, c'est d'utiliser un select avec l'attribut multiple pour pouvoir sélectionner plusieurs rôles. La notation roles[] permet de récupérer les valeurs dans un tableau.

Évidemment, le code ne fonctionnera pas si vous n'envoyez pas l'ensemble des rôles depuis votre méthode :

php

return view("customers-edit-roles", ["customer" => Customer::find($id), "roles" => Role::all()]);

Conclusion

Vous avez vu, avec Laravel, il est possible d'écrire très peu de code pour avoir un résultat plutôt complet. Évidemment, comme toujours il faudra utiliser les outils à votre disposition pour appréhender le framework à savoir :

La documentation officielle.
Les exemples / tutoriels.
Les aide mémoire.
Les forums / StackOverflow / ChatGPT / Claude.

La suite, ça sera Larablog, une plateforme de blog codé entièrement avec Laravel.

Eloquent les modèles simplement ​

Introduction ​

Créer le projet ​

Initialisation ​

Lancer le projet d’exemple ​

La base de données ​

Importer la BDD ​

Installer le générateur de modèle ​

Générer les modèles ​

Les modèles générés ​

Testons avec la liste des commandes ​

1. Ajouter un contrôleur ​

2. Déclarer la route ​

3. Déclarer la méthode ​

4. Créer la vue ​

5. Ajouter une autre donnée ​

Ajouter la vue de détail ​

1. La méthode ​

2. La route ​

3. Le template ​

Créer une commande ​

1. Créer la route ​

2. Créer le formulaire ​

3. Créer la méthode affichant le formulaire ​

4. Créer la méthode traitant le formulaire ​

La pagination ​

Créer un paiement pour le client ​

Rappel sur les relations avec Sync et Attach ​

1. Régénérer les modèles ​

2. Associer une catégorie à un client ​

Et si nous allions plus loin ​

Évolution de la base de données ​

1. Modifier la table customers ​

2. Créer la table addresses ​

3. Ajouter la relation ​

3. Regénération des modèles ​

4. Corriger votre précédente vue ​

5. Créer une nouvelle adresse ​

6. Afficher un message de succès ​

7. Supprimer une adresse ​

Créer un nouveau client ​

Modifier un client ​

Aller plus loin ​

Conclusion ​

Eloquent les modèles simplement

Introduction

Créer le projet

Initialisation

Lancer le projet d’exemple

La base de données

Importer la BDD

Installer le générateur de modèle

Générer les modèles

Les modèles générés

Testons avec la liste des commandes

1. Ajouter un contrôleur

2. Déclarer la route

3. Déclarer la méthode

4. Créer la vue

5. Ajouter une autre donnée

Ajouter la vue de détail

1. La méthode

2. La route

3. Le template

Créer une commande

1. Créer la route

2. Créer le formulaire

3. Créer la méthode affichant le formulaire

4. Créer la méthode traitant le formulaire

La pagination

Créer un paiement pour le client

Rappel sur les relations avec `Sync` et `Attach`

1. Régénérer les modèles

2. Associer une catégorie à un client

Et si nous allions plus loin

Évolution de la base de données

1. Modifier la table `customers`

2. Créer la table `addresses`

3. Ajouter la relation

3. Regénération des modèles

4. Corriger votre précédente vue

5. Créer une nouvelle adresse

6. Afficher un message de succès

7. Supprimer une adresse

Créer un nouveau client

Modifier un client

Aller plus loin

Conclusion