Laravel

1. Introduction

1.1. Qu'est-ce que Laravel ?

• Un framework PHP pour le développement web moderne.
• Un framework est comme une boite à outil à disposition

• Facilite l'implémentation de l'authentification, la sécurité, le routage, etc.

1.2. Avantages de Laravel

• Simplicité
• Documentation complète
• Communauté active.
• Architecture MVC
• Nombreux modules disponibles

1.3. Ressources

• Le plus important:
  https://laravel.com/docs/master
• Tutos par Jeffrey Way le créateur de laracast: (en anglais)
  https://laracasts.com/series/laravel-from-scratch-2026
• Un cours laravel en français:
  https://laravel.sillo.org
• Découverte de laravel 10 (en français) par Grafikart:
  https://www.youtube.com/playlist?list=PLjwdMgw5TTLXz1GRhKxSWYyDHwVW-gqrm

Plan

2. Composer

2.1. Qu'est-ce que Composer?

• Composer est un gestionnaire de dépendance (Dependency Manager) pour PHP.
• Composer permet de déclarer les librairies (aussi appelées paquets) dont vous avez besoin dans votre projet puis de les installer et les mettre à jour facilement.
• Composer va aussi gérer toutes les dépendances des librairies que l’on veut utiliser.
• Composer utilise https://packagist.org/ comme dépôt principal de librairies.
• Composer utilise un fichier “composer.json” pour gérer les librairies d’un projet.

2.2. Un exemple

{
    "name": "laravel/framework",
    "description": "The Laravel Framework.",
    "keywords": ["framework", "laravel"],
    "license": "MIT",
    "homepage": "https://laravel.com",
    "support": {
        "issues": "https://github.com/laravel/framework/issues",
        "source": "https://github.com/laravel/framework"
    },
    "authors": [
        {
            "name": "Taylor Otwell",
            "email": "taylor@laravel.com"
        }
    ],
    "require": {
        "php": "^8.3",
        "ext-ctype": "*",
        "ext-filter": "*",
        "ext-hash": "*",
        "ext-mbstring": "*",
        "ext-openssl": "*",
        "ext-session": "*",
        "ext-tokenizer": "*",
        "composer-runtime-api": "^2.2",
        "brick/math": "^0.11|^0.12|^0.13|^0.14",
        "doctrine/inflector": "^2.0.5",
        "dragonmantank/cron-expression": "^3.4",
        "egulias/email-validator": "^3.2.1|^4.0",
        "fruitcake/php-cors": "^1.3",
        "guzzlehttp/guzzle": "^7.8.2",
        "guzzlehttp/uri-template": "^1.0",
        "laravel/prompts": "^0.3.0",
        "laravel/serializable-closure": "^1.3|^2.0",
        "league/commonmark": "^2.7",
        "league/flysystem": "^3.25.1",
        "league/flysystem-local": "^3.25.1",
        "league/uri": "^7.5.1",
        "monolog/monolog": "^3.0",
        "nesbot/carbon": "^3.8.4",
        "nunomaduro/termwind": "^2.0",
        "psr/container": "^1.1.1|^2.0.1",
        "psr/log": "^1.0|^2.0|^3.0",
        "psr/simple-cache": "^1.0|^2.0|^3.0",
        "ramsey/uuid": "^4.7",
        "symfony/console": "^7.4.0|^8.0.0",
        "symfony/error-handler": "^7.4.0|^8.0.0",
        "symfony/finder": "^7.4.0|^8.0.0",
        "symfony/http-foundation": "^7.4.0|^8.0.0",
        "symfony/http-kernel": "^7.4.0|^8.0.0",
        "symfony/mailer": "^7.4.0|^8.0.0",
        "symfony/mime": "^7.4.0|^8.0.0",
        "symfony/polyfill-php84": "^1.33",
        "symfony/polyfill-php85": "^1.33",
        "symfony/process": "^7.4.0|^8.0.0",
        "symfony/routing": "^7.4.0|^8.0.0",
        "symfony/uid": "^7.4.0|^8.0.0",
        "symfony/var-dumper": "^7.4.0|^8.0.0",
        "tijsverkoyen/css-to-inline-styles": "^2.2.5",
        "vlucas/phpdotenv": "^5.6.1",
        "voku/portable-ascii": "^2.0.2"
    },
    "replace": {
        "illuminate/auth": "self.version",
        "illuminate/broadcasting": "self.version",
        "illuminate/bus": "self.version",
        "illuminate/cache": "self.version",
        "illuminate/collections": "self.version",
        "illuminate/concurrency": "self.version",
        "illuminate/conditionable": "self.version",
        "illuminate/config": "self.version",
        "illuminate/console": "self.version",
        "illuminate/container": "self.version",
        "illuminate/contracts": "self.version",
        "illuminate/cookie": "self.version",
        "illuminate/database": "self.version",
        "illuminate/encryption": "self.version",
        "illuminate/events": "self.version",
        "illuminate/filesystem": "self.version",
        "illuminate/hashing": "self.version",
        "illuminate/http": "self.version",
        "illuminate/json-schema": "self.version",
        "illuminate/log": "self.version",
        "illuminate/macroable": "self.version",
        "illuminate/mail": "self.version",
        "illuminate/notifications": "self.version",
        "illuminate/pagination": "self.version",
        "illuminate/pipeline": "self.version",
        "illuminate/process": "self.version",
        "illuminate/queue": "self.version",
        "illuminate/reflection": "self.version",
        "illuminate/redis": "self.version",
        "illuminate/routing": "self.version",
        "illuminate/session": "self.version",
        "illuminate/support": "self.version",
        "illuminate/testing": "self.version",
        "illuminate/translation": "self.version",
        "illuminate/validation": "self.version",
        "illuminate/view": "self.version",
        "spatie/once": "*"
    },
    "require-dev": {
        "ext-gmp": "*",
        "ably/ably-php": "^1.0",
        "aws/aws-sdk-php": "^3.322.9",
        "fakerphp/faker": "^1.24",
        "guzzlehttp/promises": "^2.0.3",
        "guzzlehttp/psr7": "^2.4",
        "laravel/pint": "^1.18",
        "league/flysystem-aws-s3-v3": "^3.25.1",
        "league/flysystem-ftp": "^3.25.1",
        "league/flysystem-path-prefixing": "^3.25.1",
        "league/flysystem-read-only": "^3.25.1",
        "league/flysystem-sftp-v3": "^3.25.1",
        "mockery/mockery": "^1.6.10",
        "opis/json-schema": "^2.4.1",
        "orchestra/testbench-core": "^11.0.0",
        "pda/pheanstalk": "^5.0.6|^7.0.0",
        "php-http/discovery": "^1.15",
        "phpstan/phpstan": "^2.0",
        "phpunit/phpunit": "^11.5.50|^12.5.8",
        "predis/predis": "^2.3|^3.0",
        "resend/resend-php": "^0.10.0|^1.0",
        "symfony/cache": "^7.4.0|^8.0.0",
        "symfony/http-client": "^7.4.0|^8.0.0",
        "symfony/psr-http-message-bridge": "^7.4.0|^8.0.0",
        "symfony/translation": "^7.4.0"
    },
    "conflict": {
        "tightenco/collect": "<5.5.33"
    },
    "provide": {
        "psr/container-implementation": "1.1|2.0",
        "psr/log-implementation": "1.0|2.0|3.0",
        "psr/simple-cache-implementation": "1.0|2.0|3.0"
    },
    "autoload": {
        "files": [
            "src/Illuminate/Collections/functions.php",
            "src/Illuminate/Collections/helpers.php",
            "src/Illuminate/Events/functions.php",
            "src/Illuminate/Filesystem/functions.php",
            "src/Illuminate/Foundation/helpers.php",
            "src/Illuminate/Log/functions.php",
            "src/Illuminate/Reflection/helpers.php",
            "src/Illuminate/Support/functions.php",
            "src/Illuminate/Support/helpers.php"
        ],
        "psr-4": {
            "Illuminate\\": "src/Illuminate/",
            "Illuminate\\Support\\": [
                "src/Illuminate/Macroable/",
                "src/Illuminate/Collections/",
                "src/Illuminate/Conditionable/",
                "src/Illuminate/Reflection/"
            ]
        }
    },
    "autoload-dev": {
        "files": [
            "tests/Database/stubs/MigrationCreatorFakeMigration.php"
        ],
        "psr-4": {
            "Illuminate\\Tests\\": "tests/"
        }
    },
    "extra": {
        "branch-alias": {
            "dev-master": "13.0.x-dev"
        }
    },
    "suggest": {
        "ext-apcu": "Required to use the APC cache driver.",
        "ext-fileinfo": "Required to use the Filesystem class.",
        "ext-ftp": "Required to use the Flysystem FTP driver.",
        "ext-gd": "Required to use Illuminate\\Http\\Testing\\FileFactory::image().",
        "ext-memcached": "Required to use the memcache cache driver.",
        "ext-pcntl": "Required to use all features of the queue worker and console signal trapping.",
        "ext-pdo": "Required to use all database features.",
        "ext-posix": "Required to use all features of the queue worker.",
        "ext-redis": "Required to use the Redis cache and queue drivers (^4.0|^5.0|^6.0).",
        "ably/ably-php": "Required to use the Ably broadcast driver (^1.0).",
        "aws/aws-sdk-php": "Required to use the SQS queue driver, DynamoDb failed job storage, and SES mail driver (^3.322.9).",
        "brianium/paratest": "Required to run tests in parallel (^7.0|^8.0).",
        "fakerphp/faker": "Required to generate fake data using the fake() helper (^1.23).",
        "filp/whoops": "Required for friendly error pages in development (^2.14.3).",
        "laravel/tinker": "Required to use the tinker console command (^2.0).",
        "league/flysystem-aws-s3-v3": "Required to use the Flysystem S3 driver (^3.25.1).",
        "league/flysystem-ftp": "Required to use the Flysystem FTP driver (^3.25.1).",
        "league/flysystem-path-prefixing": "Required to use the scoped driver (^3.25.1).",
        "league/flysystem-read-only": "Required to use read-only disks (^3.25.1)",
        "league/flysystem-sftp-v3": "Required to use the Flysystem SFTP driver (^3.25.1).",
        "mockery/mockery": "Required to use mocking (^1.6).",
        "pda/pheanstalk": "Required to use the beanstalk queue driver (^5.0).",
        "php-http/discovery": "Required to use PSR-7 bridging features (^1.15).",
        "phpunit/phpunit": "Required to use assertions and run tests (^11.5.50|^12.5.8).",
        "predis/predis": "Required to use the predis connector (^2.3|^3.0).",
        "psr/http-message": "Required to allow Storage::put to accept a StreamInterface (^1.0).",
        "pusher/pusher-php-server": "Required to use the Pusher broadcast driver (^6.0|^7.0).",
        "resend/resend-php": "Required to enable support for the Resend mail transport (^0.10.0|^1.0).",
        "symfony/cache": "Required to PSR-6 cache bridge (^7.4|^8.0).",
        "symfony/filesystem": "Required to enable support for relative symbolic links (^7.4|^8.0).",
        "symfony/http-client": "Required to enable support for the Symfony API mail transports (^7.4|^8.0).",
        "symfony/mailgun-mailer": "Required to enable support for the Mailgun mail transport (^7.4|^8.0).",
        "symfony/postmark-mailer": "Required to enable support for the Postmark mail transport (^7.4|^8.0).",
        "symfony/psr-http-message-bridge": "Required to use PSR-7 bridging features (^7.4|^8.0)."
    },
    "config": {
        "sort-packages": true,
        "audit": {
            "ignore": {
                "GHSA-vvj3-c3rp-c85p": "Ensure testing features are compatible with affected PHPUnit versions"
            }
        },
        "allow-plugins": {
            "composer/package-versions-deprecated": true,
            "php-http/discovery": false
        }
    },
    "minimum-stability": "dev",
    "prefer-stable": true
}

https://github.com/laravel/framework/blob/master/composer.json

2.3. Installation

• Telécharger composer https://getcomposer.org/download/

• Ajouter composer à votre PATH selon votre système.
  Ex de solution pour linux:

  sudo mv composer.phar /usr/local/bin/composer
  

• Vous pouvez vous inspirer de cette aide.

3. Installation de Laravel

Liens vers la documentation:

https://laravel.com/docs/master#creating-a-laravel-project

3.1. Deux solutions d'installation

cd exemple-app
npm install && npm run build

3.2. Lancement de l'application

Nouvelle méthode

• Se placer dans le répertoire du projet (cd exemple-app), puis:

  composer run dev
  

Ancienne méthode

• Laravel inclut un outil pour la ligne de commande: artisan

  artisan offre, entre autre, un serveur web local.

  Pour l’utiliser, on se place dans le projet (cd exemple-app), puis:

  php artisan serve
  

On peut accéder ensuite à l'application avec l’url: http://localhost:8000

3.3. Configuration et environnement

• Le fichier .env permet de configurer l’application (database, etc)
• Les répertoires bootstrap/cache et storage doivent être accessible en écriture pour que Laravel puisse y créer des fichiers.

4. Repo git exemple du cours

• Le repository de l'exemple du cours:
  https://github.com/MIASHS-UGA-PWS/example-cours-2026
• Si vous souhaitez utiliser l'exemple du cours (ou récupérer un projet existant déjà sur git, c'est à dire sans l'installer avec composer), voici la marche à suivre:
  • On clone le repo (git clone https://github.com/MIASHS-UGA-PWS/example-cours-2026)

  • On initialise le projet et installe les dépendances (composer run setup)
    

    git clone https://github.com/MIASHS-UGA-PWS/example-cours-2026
    composer run setup
    

  • Cette commande remplace les commandes suivantes:
    • on «créer» un .env (cp .env.example .env)
    • on installe les dépendances du projet (composer install)
    • on installe les dépendances front-end (npm install && npm run build)
    • on genere une clé d'application (php artisan key:generate)
    • on crée la base de donnée sqlite (touch database/database.sqlite)
    • on lance les migrations (php artisan migrate)
• Cette opération est à réaliser une seule fois. Ensuite il suffira de faire un git pull pour récupérer les mises à jour du projet.

• On peut ensuite lancer le projet:

  composer run dev
  

5. Rappel schéma MVC

6. Structure et routes

6.1. Structure des fichiers

• Models → app/Models
• Controllers → app/Http/Controllers
• Views → resources/views
• Routes → routes/web.php
  Les routes permettent de définir quelles actions seront exécutées en fonction des URLs demandées.
  En général, c'est un controller qui sera appelé.

6.2. Routage Basique (Routing)

Voyons comment fonctionne l'application de base.

Tout d'abord lançons l'application:

composer run dev 

puis ouvrons http://localhost:8000

Que ce passe t'il?

1. La requête HTTP est envoyé et «réceptionner» par le framework.
2. Le framework va déterminer quoi faire avec la requête dans le fichier routes/web.

3. En fonction de l'url demandé (ici /),y l'action ne sera pas la même.

   Route::get('/', function () {
       return view('welcome');
   });
   

4. → Le fichier resources/views/welcome.blade.php sera retourné

• Test avec une route non écrite http://localhost:8000/welcome

• Ajout d’une nouvelle route

  Route::get('/welcome', function () {
      return view('welcome');
  });
  

• Retour chaine

  Route::get('/', function () {
      return "Hello World";
  });
  

• Retour json

  Route::get('/', function () {
      return ['foo' => 'bar'];
  });
  

• Retour nouvelle vue

  Route::get('/test', function () {
      return view('test');
  });
  

  → erreur
  → on créer la vue (resources/views/test.blade.php)

6.3. Données dans la requête

Route::get('/', function () {
    $name = request('name');
    return $name;    
});

http://localhost:8000/?name=Florian

7. Les Vues avec Blade

7.1. Blade: Le système de Templating

Qu’est-ce qu’un système de templating (En anglais: template processor, template engine ou template parser) ?

Son rôle est d’aider dans la lisibilité et la logique du projet en général. Au lieu d’écrire directement du PHP dans le code HTML, on va utiliser le langage du système de Templating (Pour Laravel, c’est Blade, mais il en existe d’autres: Smarty, Twig, etc.)

Par exemple, pour un menu qui doit être le même sur plusieurs page, on peut créer un fichier template menu.blade.php puis l’utiliser ensuite dans d’autre fichiers template avec : @extends(menu)

Similaire à l’utilisation de include avec PHP, mais dans ce cas, on sépare bien le langage utilisé pour les templates et les vues et le code PHP.

• Dans le template (layout.blade.php)

  @yield('title','Titre par défaut')  // valeur par défaut
  @yield('content')
  

• Dans la vue (home.blade.php)

  @extends('layout')
  
  {{-- On peut aussi déclarer la section en inline --}}
  {{-- @section('title','Title - Home') --}}
  
  @section('content')
  <h1>Home</h1>
  @endsection
  

• Route (Routes/web.php)

  Route::get('/', function () {
    return view('home');
  });
  

7.2. Passer des données à la vue

Route::get('/', function () {
    $tasks = [
        'Aller faire les courses',
        'Aller à la gym',
        'Dormir'
    ];
    return view('home',[
        'tasks' => $tasks
    ]);
});

@extends('layout')

@section('title','<h1>Home</h1>')

@section('content')

    <ul>
        <?php foreach ($tasks as $task ) : ?>
            <li><?= $task; ?></li>
        <?php endforeach; ?>
    </ul>

@endsection

7.3. Passer des données à la vue

Route::get('/', function () {
    $tasks = [
        'Aller faire les courses',
        'Aller à la gym',
        'Dormir'
    ];
    return view('home',[
        'tasks' => $tasks
    ]);
});

@extends('layout')

@section('title','<h1>Home</h1>')

@section('content')

    <ul>
        @foreach ($tasks as $task )
            <li>{{ $task }}</li>
        @endforeach
    </ul> 

@endsection

7.4. Passer des données à la vue

Route::get('/', function () {
    $tasks = [
        'Aller faire les courses',
        'Aller à la gym',
        'Dormir'
    ];
    return view('home',[
        'tasks' => $tasks,
        'test' => 'Mon test'
    ]);
});

@extends('layout')

@section('title','<h1>Home</h1>')

@section('content')

<h2>{{ $test }}</h2>

    <ul>
        @foreach ($tasks as $task )
            <li>{{ $task }}</li>
        @endforeach
    </ul> 

@endsection

7.5. Passer des données à la vue

Route::get('/', function () {
    $tasks = [
        'Aller faire les courses',
        'Aller à la gym',
        'Dormir'
    ];
    return view('home',[
        'tasks' => $tasks,
        'test' => request('title')
    ]);
});

@extends('layout')

@section('title','<h1>Home</h1>')

@section('content')

<h2>{{ $test }}</h2>

    <ul>
        @foreach ($tasks as $task )
            <li>{{ $task }}</li>
        @endforeach
    </ul> 

@endsection

7.6. Passer des données à la vue

Route::get('/', function () {
    $tasks = [
        'Aller faire les courses',
        'Aller à la gym',
        'Dormir'
    ];
    return view('home',[
        'tasks' => $tasks,
        'test' => '<script>alert("coucou")</script>'
    ]);
});

@extends('layout')

@section('title','<h1>Home</h1>')

@section('content')

<h2>{{ $test }}</h2>

    <ul>
        @foreach ($tasks as $task )
            <li>{{ $task }}</li>
        @endforeach
    </ul> 

@endsection

7.7. Passer des données à la vue

Route::get('/', function () {
    $tasks = [
        'Aller faire les courses',
        'Aller à la gym',
        'Dormir'
    ];
    return view('home',[
        'tasks' => $tasks,
        'test' => 'Mon test'
    ]);
    // ou
    return view('home')->withTasks($tasks)->withTest('Mon test with 1');
    // ou
    return view('home')->with([
            'tasks' => $tasks,
            'test' => 'Mon test with 2'
    ]);
});

7.8. Passer des données à la vue

Route::get('/', function () {
    return view('home',[
        'title' => 'Home'
    ]);
});

@extends('layout')

@section('title')
  <h1>{{ $title }}</h1>
@endsection

@section('content')
  <p>Contenu de la page d'accueil</p>
@endsection

8. Les Controllers

/*
Route::get('/', function () {
    return view('home',[
        'title' => 'Home'
    ]);
});
*/

use App\Http\Controllers\PagesController;
Route::get('/', [PagesController::class, 'home']);

8.1. Controller

L’outil artisan permet aussi la création de fichiers dans l’application!

php artisan make:controller PagesController

Le fichier est automatiquement créé dans app/Http/Controllers Ensuite, on peut ajouter la méthode home et inclure le code que l’on utilisait pour appeler la view:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class PagesController extends Controller
{
    public function home()
    {
        return view('home',[
            'title' => 'Home'
        ]);
    }
}

8.2. Ajouter des pages

• On va «router» de nouvelles url vers de nouvelles méthodes de notre controller Routes/web.php

  Route::get('/', [PagesController::class, 'home']);
  Route::get('/about', [PagesController::class, 'about']);
  Route::get('/contact', [PagesController::class, 'contact']);
  

• Puis on va ajouter de nouvelles méthode à notre controller app/Http/Controllers/PagesController.php

  <?php
  
  namespace App\Http\Controllers;
  
  use Illuminate\Http\Request;
  
  class PagesController extends Controller
  {
      public function home()
      {
          return view('home',[
              'title' => 'Home'
          ]);
      }
      public function about()
      {
          return view('about');
      }
      public function contact()
      {
          return view('contact');
      }
  }
  
  

• On créer les vues about.blade.php et contact.blade.php

  @extends('layout')
  
  @section('title')
    <h1>{{ $title }}</h1>
  @endsection
  
  @section('content')
    <p>Contenu de la page about</p>
  @endsection
  

• On ajoute le title dans les données qu'on passe à notre vue dans le controller

  public function about()
  {
      return view('about',[
          'title' => 'About'
      ]);
  }
  public function contact()
  {
      return view('contact',[
          'title' => 'Contact'
      ]);
  }
  

  • On peut tester
    http://localhost:8000/about
    http://localhost:8000/contact

9. Recap

• Création d’un projet avec composer:
  (ou l'outil laravel laravel new project)

  composer create-project laravel/laravel example-app 
  

• Pour définir les routes de l’application (web), il faut éditer le fichier routes/web.php
• Les contrôleurs sont situés dans le répertoire app/Http/Controllers

• Ils peuvent être générés automatiquement avec la commande:

  php artisan make:controller MonController 
  

• Les vues sont situées dans le répertoire resources/views

• On peut passer de la données au vue en second paramètre de la fonction view

  $monTableauData = ['attr' => 'value', 'attr2' => 'value2'];
  return view('mavue', $monTableauData);
  

• On utilise blade dans les vues et on peut afficher les données avec par exemple {{$attr}}
• Les assets de l’application dans les répertoire resources/js, resources/sass, etc

10. Bases de données et Migration

10.1. Installation / Configuration

• On commence par la création d’une base de données.
• On configure ensuite les accès dans le fichier .env

DB_CONNECTION=sqlite
DB_DATABASE=/ABSOLUTE_PATH/database/database.sqlite

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

• On lance ensuite en ligne de commande la commande suivante:

  php artisan migrate 
  

10.2. Avantages

• Avantages de php artisan migrate:
  • On définit nos schémas de base et nos modifications en classe, pas besoin d’écrire du SQL
  • Si on est en équipe, on clone, on migrate et on a instantanément le projet qui tourne
  • On a un pseudo «versionning» de la DB
  • On peut rollback (revenir en arrière) avec php artisan migrate:rollback

10.3. Exemple

• Par exemple, si on veut changer le champ name dans users…?
  • On édite database/migrations/create_users_table.php
  • On change par exemple name en username

  • On lance un rollback:

    php artisan migrate:rollback
    

  • On relance ensuite:

    php artisan migrate 
    

  • On peut voir dans la base que ça a changé.

10.4. Migrate:fresh

On peut facilement réinitialiser une base de données si on veut “recommencer”

On lance la commande:

php artisan migrate:fresh

Cette commande efface toutes les tables puis relance la migration

!!! Attention… à utiliser avec parcimonie et surtout pas en production !!!

10.5. Création de migrations

Pour créer des nouvelles migrations, on peut utiliser artisan

• Description de la commande:

  php artisan help make:migration 
  

• Création d’une migration:

  php artisan make:migration create_projects_table
  

• La commande précédente crée le fichier: database/migrations/create_projects_table.php :

10.5. Création de migrations

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::create('projects', function (Blueprint $table) {
            $table->id();
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::dropIfExists('projects');
    }
};

• create → Schema::create
• up → migrate
• down → rollback
• garder le timestamps c’est une bonne idée

10.5. Création de migrations

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::create('projects', function (Blueprint $table) {
            $table->id();
            $table->string('title');
            $table->text('description');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::dropIfExists('projects');
    }
};

• Pour exécuter notre nouvelle migration:

  php artisan migrate
  

  php artisan migrate

• On peut vérifier dans notre base de données que la table a bien été créée.

• On peut revenir en arrière:

  php artisan migrate:rollback
  

• La table est supprimée.
• La méthode down() est appelé lors du rollback. On peut donc adapter les migration en éditant les méthodes up et down
• Si erreur on peut migrate:fresh

10.6. Récap

• Après création d’une base de données, on configure les accès dans le fichier .env
• On peut lancer des migrations de base de données avec l’outil artisan: php artisan migrate
• On peut aussi créer de nouvelles migrations et revenir en arrière facilement
• On peut réinitialiser sa base de données avec php artisan migrate:fresh
• Ce sont les méthodes up et down d’une migration qui sont appelées lors des migrate et des rollback
• On peut ensuite facilement modifier la méthode up pour configurer la table de la base de données sans avoir à écrire de SQL

11. Les Modèles et Eloquent ORM

11.1. BDD + Modèles = Eloquent ORM

• Comment accède-t-on à la table?
• Comment insère-t-on des données?
• Comment interroge-t-on la base?

11.2. Eloquent

Eloquent est l’ ORM (Object Relational Mapping) de Laravel.

Un ORM permet à un modèle d’interagir facilement avec la base de données (sa table, mais aussi ses relations)

• Pour créer un nouveau modèle:

  php artisan make:model Project
  

• Le modèle est créé dans le répertoire: app/Models/Project.php
• On peut maintenant utiliser toutes les fonctionnalités de Eloquent: https://laravel.com/docs/master/eloquent

12. Tinker: Piloter laravel en ligne de commande

Tinker est un outil artisan qui permet d’interagir avec la base de données depuis la ligne de commande. En réalité, on peut accéder aux fonctionnalités de Laravel, depuis la ligne de commande, pour effectuer des tests, essais, vérifications, création, etc.
→ On le lance avec la commande:

php artisan tinker

php artisan tinker
Psy Shell v0.12.0 (PHP 8.3.2 — cli) by Justin Hileman
> 2+2
= 4

> App\Models\Project::all();
= Illuminate\Database\Eloquent\Collection {#5761
    all: [],
  }

> use App\Models\Project;
> Project::all();
= Illuminate\Database\Eloquent\Collection {#5710
    all: [],
  }

> Project::first();
= null

> Project::latest()->first();
= null

> $project = new Project;
= App\Models\Project {#4994}

>  $project->title = 'Mon premier projet';
= "Mon premier projet"

> $project->description = 'Lorem ipsum';
= "Lorem ipsum"

> $project
= App\Models\Project {#4994
    title: "Mon premier projet",
    description: "Lorem ipsum",
  }

> $project->save();
= true

→ On peut vérifier que l’objet a bien été créé dans la base de données.

php artisan tinker
Psy Shell v0.12.0 (PHP 8.3.2 — cli) by Justin Hileman
> Project::first();
= App\Models\Project {#4995
    id: 1,
    title: "Mon premier projet",
    description: "Lorem ipsum",
    created_at: "2024-02-05 22:58:45",
    updated_at: "2024-02-05 22:58:45",
  }

> Project::first()->title;
= "Mon premier projet"

> Project::first()->description;
= "Lorem ipsum"

> Project::all();
= Illuminate\Database\Eloquent\Collection {#5985
    all: [
      App\Models\Project {#5975
        id: 1,
        title: "Mon premier projet",
        description: "Lorem ipsum",
        created_at: "2024-02-05 22:58:45",
        updated_at: "2024-02-05 22:58:45",
      },
    ],
  }

→ On créer un nouveau projet

13. Recap

• Eloquent est une classe permettant aux modèles d’interagir facilement avec la base de données. Nous reviendrons plus en détail sur Eloquent par la suite.
• Tinker est un outil permettant d’utiliser son application Laravel depuis la ligne de commande. On peut facilement appeler les classes et méthodes de l’application.

14. Un exemple complet MVC

Nous allons faire un exemple complet MVC d'une page affichant des "projets" stocker en base de données.

Il nous faut:

• Créer une nouvelle route pour traiter l'url /project
• Un controller qui va gérer les actions concernant les projets
• Une méthode de se controller qui va:
  • récupérer les projets grâce au model
  • retourner une vue et lui passer de la donnée (les projets)
• Une vue qui affiche les projets

14.1. Création de la route et du controller

• On définit les routes de l’application dans le fichier routes/web.php

  use App\Http\Controllers\ProjectController;
  Route::get('/project', [ProjectController::class, 'index']);
  

• On créer un nouveau controller avec la commande:

  php artisan make:controller ProjectController;
  

  → Le fichier est créé dans: app/Http/Controller/ProjectController.php

14.2. Appel de la vue

• On ajoute une méthode index

  app/Http/Controller/ProjectController.php

  <?php
  
  namespace App\Http\Controllers;
  
  use Illuminate\Http\Request;
  
  class ProjectController extends Controller
  {
      //
      public function index()
      {
          return view('project.index');
      }
  }
  
  

• On créer un fichier vue dans le répertoire resources/views :
  project/index.blade.php
  → On voit qu'on peut ranger dans des sous dossier et appeler le fichier vue avec view('folder.file')
• On lance l’application avec: composer run dev et on peut voir la page dans le navigateur

14.3. Appel du model

• On va maintenant coder la méthode index du contrôleur ProjectsController

• On va récupérer les projets:

  $projects = \App\Models\Project::all();
  

  ou

  use App\Models\Project;
  $projects = Project::all();
  

14.4. Appel du model

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\Project;

class ProjectController extends Controller
{
    //
    public function index()
    {
        $projects = Project::all();
        return $projects;
    }
}

[
    {
        "id": 1,
        "title": "Mon premier projet",
        "description": "Lorem ipsum",
        "created_at": "2024-02-05T22:58:45.000000Z",
        "updated_at": "2024-02-05T22:58:45.000000Z"
    },
    {
        "id": 2,
        "title": "Mon projet 2",
        "description": "Lorem ipsum 2",
        "created_at": "2024-02-05T23:04:15.000000Z",
        "updated_at": "2024-02-05T23:04:15.000000Z"
    }
]

14.5. On passe les données à la vue

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\Project;

class ProjectController extends Controller
{
    //
    public function index()
    {
        $projects = Project::all();
        return view('project.index', ['projects' => $projects]);
    }
}

ou

return view('project.index', compact('projects'));

voir https://www.php.net/manual/en/function.compact.php

14.6. Affichage des projets dans la vue

• Dans la vue resources/views/projects/index.blade.php on itère sur les projets:

  <h1>Projects</h1>
  <ul>
      @foreach ($projects as $project)
      <li>{{ $project->title }}</li>
      @endforeach
  </ul>