L L 

S H S H CTO, Formateur, Contributeur. @s_hulard     

L ? L ? 

U ' … U ' … 2011: Premier commit, 2013: v4.0.0, 2015: v5.0.0, 2019: v5.9.0 ? 

D … D … … pour les habitués à Symfony 

U ! U ! Et une documentation très accessible… 

T T ▶ composer.json ▶ .env ▶ ORM (ActiveRecord) + Migrations ▶ CLI ▶ Templates ▶ Intégration frontend (Elixir) 

U U # Création d'un projet vierge composer create-project laravel/laravel # Démarrage du serveur web intégré à PHP ./artisan serve # Homepage: http://localhost:8000 

A A ├── app │ ├── Console │ │ └── Kernel.php │ ├── Exceptions │ ├── Http │ │ ├── Controllers │ │ ├── Middleware │ │ └── Kernel.php │ ├── Providers │ └── User.php ├── bootstrap ├── config │ ├── app.php │ └── … ├── database │ ├── migations │ ├── seeds ├── routes │ ├── api.php │ ├── web.php │ └── … ├── public ├── resources └── storages 

No content

U U //routes/api.php Route::post('/upload', function() { request('image')->store('images'); }); 1 2 3 4 

F F Route::post('/upload', function() { ... }); 

H H /** @var UploadedFile */ request('image')->store('images'); 

Not so bad… …l'amélioration continue ! 

I I use Illuminate\Http\Request; Route::post('/upload', function(Request $request) { $request 1 2 3 4 ->file('image') 5 ->store('images'); 6 }); 7 

V V $request->validate([ 'image' => 'required|image' ]); Route::post('/upload', function(Request $request) { 1 2 3 4 5 $request->file('image')->store('images'); 6 }); 7 

C C use Illuminate\Contracts\Filesystem\Filesystem; function(Request $request, Filesystem $filesystem) { $file = $request->file('image'); $filesystem->put( sprintf('images/%s', $file->hashName()), $file ); 1 2 Route::post( 3 '/upload', 4 5 //[...] Validation 6 7 8 9 10 11 12 } 13 ); 14 

No content

S S Chaque chose à sa place… …Contrôleur, Route, Service. 

C C namespace App\Http\Controllers\Api\User; class UploadProfilePicture { private $filesystem; public function __construct(Filesystem $filesystem) { $this->filesystem = $filesystem; } public function __invoke(Request $request) { // Action… } } 1 2 3 4 5 6 7 8 9 10 11 12 13 14 

R R Route::post( '/upload', 'Api\User\UploadProfilePicture' ); 1 2 3 4 

S S Les services sont des objets… … construits et gérés par le conteneur … … injectés à l'exécution. 

D D APPSERVICEPROVIDER::BOOT APPSERVICEPROVIDER::BOOT use Illuminate\Contracts\Filesystem\Filesystem; use Illuminate\Filesystem\FilesystemManager; use Illuminate\Foundation\Application; $this->app->bind( Filesystem::class, function(Application $app) { return $app ->make(FilesystemManager::class) ->disk('local'); } ); 1 2 3 4 5 6 7 8 9 10 11 12 

C B C B //... use App\Http\Controllers\Api\User; $this->app ->when(User\UploadProfilePicture::class) ->needs(Filesystem::class), ->give(function(Application $app) { return $app ->make(FilesystemManager::class) ->disk('local'); }); 1 2 3 4 5 6 7 8 9 10 11 

V ' V ' Arrêter le processus le plus tôt possible… … Middlewares et FormRequest. 

M ? M ? Centraliser les comportements… 

F R F R ./artisan make:request UploadUserProfile namespace App\Http\Requests; use Illuminate\Foundation\Http\FormRequest; use Illuminate\Http\UploadedFile; class UploadUserProfile extends FormRequest { public function rules() { return ['image' => 'required|image']; } public function image(): UploadedFile { return $this->validated()['image']; } } 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

C C namespace App\Http\Controllers\Api\User; use App\Http\Requests\UploadUserProfile; class UploadProfilePicture { public function __construct(Filesystem $filesystem) { $this->filesystem = $filesystem; } public function __invoke(UploadUserProfile $request) { $image = $request->image(); $this->filesystem->put('images', $image); } } 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 

E ! E ! Une micro application, Testable, maintenable, Et surtout pas de magie ! 

A … A … Laravel est un outil et seulement un outil… Très rapide pour prototyper … Très riche en fonctionnalités par défaut … Mais pas adapté à tout les cas ! 

A … A … Ne pas prendre tout les raccourcis possible… Prendre le temps d'apprendre… Réfléchir au projet dans son ensemble… Comprendre l'architecture de votre code. 

https://joind.in/talk/a77e5