all aboard for laravel 5.1

All Aboard for Laravel 5.1Jason McCreary "JMac" @gonedark

All Aboard for Laravel 5.1 - Jason McCreary - php[world] 2015

A short rant about frameworksChoose wisely and code carefully

2


Talk the Talk

1. What’s New in Laravel 5.02. Upgrading from Laravel 4.23. What’s New in Laravel 5.14. What’s coming in Laravel 5.2

3


The Goal

“To get you familiar with the new features in Laravel so you are comfortable upgrading your projects to 5.1”

4


Why Upgrade?

“Laravel 5.1 is the first release of Laravel to receive long term support. Laravel 5.1 will receive bug fixes for 2 years and security fixes for 3 years. This support window is the largest ever provided for Laravel and provides stability and peace of mind for larger, enterprise clients and customers.”

5


What’s New…In Laravel 5.0

6


New Folder Structure

• Follows PSR-4 naming conventions• App namespacing• Models live in the default namespace

• Everything related to HTTP lives under Http/ (controllers, middleware, requests)

• Views live outside the App namespace within resources/.

7


Folder Structure

8

4.2 5.0


App Folder

9

4.2 5.0


Namespacing

<?php namespace App; // ...

class User extends Model { // ... }

10


Namespacing

<?php namespace App\Http\Controllers; class HomeController extends Controller {

public function index() { return view('home'); } }

11


Namespacing"autoload": { "classmap": [ "app/commands", "app/controllers", "app/models", "app/database/migrations", "app/database/seeds", "app/tests/TestCase.php" ] },

12

"autoload": { "classmap": [ "database" ], "psr-4": { "App\\": "app/" } },

4.2 5.0


New Objects

• Events are now objects, not strings!• Command objects allow simpler job processing• Requests are now objects• Middleware objects to replace Filters

13


Middleware

“HTTP middleware provide a convenient mechanism for filtering HTTP requests entering your application.”

14


Middleware

<?php namespace App\Http\Controllers; class HomeController extends Controller { public function __construct() { $this->middleware('auth'); }

// ... }

15


Middleware<?php namespace App\Http\Middleware;

use Closure;

class TimeoutMiddleware {

public function handle($request, Closure $next) {

if (abs(time() - $request->input(‘ttl’)) > 300) {

return redirect('timeout');

}

return $next($request);

}

}

16


Form Request Objects

“A simple way to customize request validation automatically.”

17


Form Request Objects<?php namespace App\Http\Requests;

class RegisterRequest extends FormRequest {

public function rules() {

return [

'email' => 'required|email|unique:users',

'password' => 'required|confirmed|min:8'

];

}

}

18


Controller Method Injection

“In addition to constructor injection, you may now type-hint dependencies on controller methods. These objects will be resolved and available along with any route parameters.”

19


Controller Method Injection

public function register(

RegisterRequest $request,

RegistrationRepository $registration)

{

// ...

}

20


Controller Validation

"If FormRequests are a little too much, the Laravel 5 base controller now includes a ValidatesRequests trait. This trait provides a simple validate() method to validate incoming requests."

21


Controller Validation

public function register(Request $request)

{

$this->validate($request, [

'email' => 'required|email|unique:users',

'password' => 'required|confirmed|min:8'

]);

}

22


Environment Configuration

“Laravel 5 uses the DotEnv library to condense all configuration values into a single .env file. These values get loaded into $_ENV and available through the env() helper method.”

23


Environment ConfigurationAPP_ENV=local APP_DEBUG=true APP_KEY=SomeRandomString DB_HOST=localhost DB_DATABASE=homestead DB_USERNAME=homestead DB_PASSWORD=secret CACHE_DRIVER=file SESSION_DRIVER=file

24

<?php

return array(

'APP_KEY' => 'secretkey',

);

4.2 5.0


Environment Configuration

25

<?php return [ 'debug' => env('APP_DEBUG'),

// ... 'key' => env('APP_KEY', 'SomeRandomString'), // ...];


Artisan Updates

• Now includes several make commands to generate common objects

• tinker is now backed by Psysh for a more powerful REPL

• route commands for listing and caching routes

26


Authentication

“User registration, authentication, and password reset controllers are now included out of the box, as well as simple corresponding views.”

27


User Model (4.2)<?php use Illuminate\Auth\UserTrait; use Illuminate\Auth\UserInterface; use Illuminate\Auth\Reminders\RemindableTrait; use Illuminate\Auth\Reminders\RemindableInterface;class User extends Eloquent implements UserInterface, RemindableInterface { use UserTrait, RemindableTrait; protected $table = 'users'; protected $hidden = array('password', 'remember_token');}

28


User Model (5.0)<?php namespace App; use Illuminate\Auth\Authenticatable; use Illuminate\Database\Eloquent\Model; use Illuminate\Auth\Passwords\CanResetPassword;use Illuminate\Contracts\Auth\Authenticatable as AuthenticatableContract;use Illuminate\Contracts\Auth\CanResetPassword as CanResetPasswordContract; class User extends Model implements AuthenticatableContract, CanResetPasswordContract { use Authenticatable, CanResetPassword; protected $table = 'users'; protected $fillable = ['name', 'email', 'password']; protected $hidden = ['password', 'remember_token'];}

29


Blade

“By default, Laravel 5.0 escapes all output from both the {{ }} and {{{ }}} Blade directives. A new {!! !!} directive has been introduced to display raw, unescaped output.”

30


Libraries and Packages

• Laravel Elixir - asset management• Laravel Socialite - authentication with Oauth services• Flysystem - filesystem abstraction library• Laravel Scheduler - command manager

31


Upgrading LaravelFrom 4.2 to 5.0

32


Two Approaches

• “New move-in”• “Update in-place”

33


What to do?

“As always, it depends. However, the documentation recommends migrating your 4.2 app to a new Laravel 5 app. So, new move-in it is.”

34


Basic Steps1. Create a new Laravel 5 app2. Migrate configuration3. Move app files4. Add namespacing5. Review Bindings6. Miscellaneous changes7. Blade Tag changes8. Update dependencies9. Cross fingers

35


Do not pass 5.0!

“Going directly to 5.1 will make the migration more complicated as there are significant changes between 5.0 and 5.1. Do not pass 5.0. Otherwise you will not collect $200 and you will go to jail.”

36


Create new Laravel 5 app

composer create-project laravel/laravel --prefer-dist

37


Create new Laravel 5 app

composer global require “laravel/installer=~1.1”

laravel new project-name

38


Migrate Configuration

1. Copy configuration from your 4.2 app’s env.php to .env

2. Compare configurations from your 4.2 app’s config/

3. Recreate environment configurations from your 4.2 app’s config/env/ to.env

4. Update environment configurations to use env()

39



“Be sure to leave .env.example file in your project. It should contain placeholder values that will make it easy for other developers to copy and configure for their environment.”

40



“When managing multiple environments, you may find it easiest to create several .env files and symlink the .env within each environment.”

41


Move Files

42

4.2 5.0


Move Files

• routes.php to app/Http/routes.php

• app/views to resources/views

• app/database to database/

43


Add namespace

“You do not need to do this. You can keep everything in the global namespace and add the paths to the classmap just as in Laravel 4.2. However, not doing so carries over technical debt as your project will not truly follow Laravel 5.0’s configuration.”

44


Add namespace

<?php namespace App\Http\Controllers; class YourController extends Controller {

// ... }

45


Add namespace

<?php namespace App; class YourModel extends Eloquent {

// ... }

46


Review Bindings

"Move any service container bindings from start/global.php to the register method of the app/Providers/AppServiceProvider.php file."

47


Miscellaneous Changes

•SoftDeletingTrait is now SoftDeletes•User Authentication changes•Pagination method changes

•Oh yeah, and the Form and Html Facades are gone.

48


Blade Changes1. Cry2. Bargain3. Face reality4. Start changing every {{ }} to {!! !!}

5. Remove all blade comment tags {{-- --}} (you should have known better)

6. Smile

49


Update your dependencies

"Review your dependencies then run composer update"

50


Cross fingers

51


Questions…Ask now! Cause we’re moving to 5.1

53


What’s New…In Laravel 5.1

54


Project Updates

• Long Term Support• Requires PHP > 5.5.9• Follows PSR-2• Updated Documentation• Uses openssl for encryption, instead of mcrypt

55


App Folder

56

5.0 5.1


Event Broadcasting

"makes it easy to broadcast your events over a websocket connection."

57


Middleware Parameters<?php namespace App\Http\Middleware;

use Closure;

class RoleMiddleware {

public function handle($request, Closure $next, $role) {

if (!$request->user()->hasRole($role)) {

// Redirect...

}

return $next($request);

}

}

58


Middleware Parameters

Route::put(

‘post/{id}',

['middleware' => 'role:editor', function ($id) {

// ...

}]

);

59


Focus on Testing

• Stronger integration testing• Model factories

60


What’s Coming…In Laravel 5.2

61


Laravel 5.2

• Coming December 2015• Route filters have been deprecated in preference of middleware.

• *_fetch methods deprecated in favor of *_pluck

62


Resources

• What’s new in Laravel 5 Laracasts• Laravel Official Upgrade Guide• Laravel In-Place Upgrade Guide• What’s new in Laravel 5.1 Laracasts

63

https://laracasts.com/series/whats-new-in-laravel-5

http://laravel.com/docs/5.1/upgrade#upgrade-5.0

http://slashnode.com/definitive-laravel-4-to-laravel-5-migration-guide/

https://laracasts.com/series/whats-new-in-laravel-5-1


Questions…@gonedark on Twitter

64

all aboard for laravel 5.1

Internet