php yield rest,Laravel学习笔记五-会话控制与RESTful

由于 HTTP 协议是无状态的，我们无法在两个页面之间保证用户身份的同步，因此我们需要借助会话在浏览器中临时存储用户的身份信息，进而保证在同一浏览器中，用户在不同页面具有相同的登录状态。

一、RESTful

下面我们还需要对路由进行配置，添加一些接下来需要用到的路由，新增的路由分别对应会话控制器的三个动作：create, store, destroy。

app/Http/routes.php

Route::get('/', 'StaticPagesController@home')->name('home');

Route::get('/help', 'StaticPagesController@help')->name('help');

Route::get('/about', 'StaticPagesController@about')->name('about');

// 用户注册

Route::get('/signup', 'UsersController@create')->name('signup');

// 资源路由

resource('users', 'UsersController');

// 会话控制，登录，退出

get('login', 'SessionsController@create')->name('login');

post('login', 'SessionsController@store')->name('login');

delete('logout', 'SessionsController@destroy')->name('logout');

新增的路由功能如下:

HTTP 请求URL 动作 作用

GET /login SessionsController@create 显示登录页面

POST /login SessionsController@store 创建新会话(登录)

DELETE /logout SessionsController@destroy 销毁会话(退出登录)

我们可以使用 Laravel 提供的 route:list命令来查看已添加的路由。

我们可以从上面的列表清晰的看到所有在 routes.php 中被定义好的路由，这将帮助我们更好的理解应用的基础架构。

Laravel 遵从 RESTful 架构的设计原则，将数据看做一个资源，由 URI 来指定资源。对资源进行的获取、创建、修改和删除操作，分别对应 HTTP 协议提供的 GET、POST、PATCH 和 DELETE 方法。当我们要查看一个 id 为 1 的用户时，需要向 /users/1 地址发送一个 GET 请求，当 Laravel 的路由接收到该请求时，默认会把该请求传给控制器的 show 方法进行处理。

Laravel 为我们提供了 resource 方法来定义用户资源路由。

新增的 resource 方法将遵从 RESTful 架构为用户资源生成路由。该方法接收两个参数，第一个参数为资源名称，第二个参数为控制器名称。

resource('users', 'UsersController');

上面代码将等同于：

get('/users', 'UsersController@index')->name('users.index');

get('/users/{id}', 'UsersController@show')->name('users.show');

get('/users/create', 'UsersController@create')->name('users.create');

post('/users', 'UsersController@store')->name('users.store');

get('/users/{id}/edit', 'UsersController@edit')->name('users.edit');

patch('/users/{id}', 'UsersController@update')->name('users.update');

delete('/users/{id}', 'UsersController@destroy')->name('users.destroy');

可以看到使用 resource 方法让我们少写了很多代码，且严格按照了 RESTful 架构对路由进行设计。

生成的资源路由列表信息如下所示：

这时我们访问 http://sample.app/users/1 页面，会出现如下页面。这是因为该路由请求由 UsersController 里面的 show 方法来处理.

二、两种页面提示信息

1.Validate()验证参数错误提示

如果Vlalidate()验证参数错误，则会在视图页面抛出erros的错误信息，并退出程序，这时，我们需要在视图页面判断是否有错误抛出，如果有则显示错误信息。由于错误提示是一个通用的，所以，这里我们封装一个错误的局部视图页面，然后在其他页面引入，这样可以大大增加代码的复用性和简洁性。

// 输入参数验证

$this->validate($request, [

'email' => 'required|email|max:255',

'password' => 'required'

]);

错误提示页面：

views/shared/errors.blade.php

@if(count($errors) > 0)

@foreach($errors->all() as $error)

{{ $error }}

@endforeach

@endif

在登录页面引用errors.blade.php：

@extends('layouts.default')

@section('title', '登录')

@section('content')

登录

@include('shared.errors')

{{ csrf_field() }}

邮箱：

密码：

登录

---

还没账号？现在注册！

@stop

2.session()->flash()闪现提示消息

如在用户登录成功或失败时，我们需要给用户一个友好的提示信息，以往我都是在服务端返回一个JS的弹出框，给出提示信息，这里Laravel为我们提供了一个非常好的提示信息，就是使用会话的flash()方法。

由于 HTTP 协议是无状态的，所以 Laravel 提供了一种用于临时保存用户数据的方法 - 会话(Session)，并附带支持多种会话后端驱动，可通过统一的 API 进行使用。

我们可以使用 session() 方法来访问会话实例。而当我们想存入一条缓存的数据，让它只在下一次的请求内有效时，则可以使用 flash 方法。flash 方法接收两个参数，第一个为会话的键，第二个为会话的值，我们可以通过下面这行代码的为会话赋值。

session()->flash('success', '欢迎，您将在这里开启一段新的旅程~');

之后我们可以使用 session()->get('success') 通过键名来取出对应会话中的数据，取出的结果为 欢迎，您将在这里开启一段新的旅程~。

接下来的消息提示我们会用会话进行闪存，并分别为其设定好指定的键。danger, warning, success, info这四个键名在 Bootstrap 分别具有不同样式展现效果，因此后面我们将使用这几个键名作为消息提示的专有设定。

现在让我们加入消息提醒视图，让会话消息在视图上进行展示。

resources/views/shared/messages.blade.php

@foreach (['danger', 'warning', 'success', 'info'] as $msg)

@if(session()->has($msg))

{{ session()->get($msg) }}

@endif

@endforeach

session()->has($msg) 可用于判断会话中 $msg 键对应的值是否为空，若为空则在页面上不进行显示。最后，我们通过 session()->get($msg)来取出对应的值并在页面上进行显示。

现在，让我们在全局通用视图中加入消息提醒视图。

resources/views/layouts/default.blade.php

@yield('title', 'Sample App') - Laravel 入门教程

@include('layouts._header')

@include('shared.messages')

@yield('content')

@include('layouts._footer')

当我们再次注册一个验证通过的用户时，能够看到消息提醒在页面上成功展示。

三、登录信息

1.密码验证方法Auth::attempt()

借助 Laravel 提供的 Auth 的 attempt 方法可以让我们很方便的完成用户的身份认证操作，如下所示：

if (Auth::attempt(['email' => $email, 'password' => $password])) {

// 该用户存在于数据库，且邮箱和密码相符合

}

attempt 方法会接收一个数组来作为第一个参数，该参数提供的值将用于寻找数据库中的用户数据。因此在上面的例子中，用户信息将使用 email 字段的值在数据库中进行查找，如果用户被找到，在将 password 的值进行哈希加密并与数据库中已加密过的密码进行匹配，如果匹配后两个值完全一致，则会创建一个通过认证的会话给用户。会话获取到之后，即视为用户登录成功。当用户身份认证成功 attempt 方法会返回 true，反之则返回 false。

会话控制器登录操作：app/Http/Controllers/SessionsController.php

namespace App\Http\Controllers;

use Auth;

.

.

.

class SessionsController extends Controller

{

// 展示登录视图

public function create()

{

return view('sessions.create');

}

// 存储数据

public function store(Request $request)

{

// 输入参数验证

$this->validate($request, [

'email' => 'required|email|max:255',

'password' => 'required'

]);

$credentials = [

'email' => $request->email,

'password' => $request->password,

];

// 账号密码验证

if(Auth::attempt($credentials))

{

dd(Auth::user());

// 登录成功后的操作

session()->flash('success', '欢迎回来！');

return redirect()->route('users.show', [Auth::user()]);

}

else

{

// 登录失败后的操作

session()->flash('danger', '很抱歉，您的邮箱和密码不匹配');

return redirect()->back();

}

}

}

2.获取登录成功后用户的信息

Larvel 为我们提供了用Auth::user()方法来获取当前登录用户的信息

Auth::user()

我们可以使用dd(Auth::user());打印看下获取到的当前登录用户信息：

3.判断用户是否登录Auth::check()

Laravel 提供了 Auth::check() 方法用于判断当前用户是否已登录，已登录返回 true，未登录返回 false。

4.退出登录Auth::logout()

我们可以通过调用 Laravel 默认提供的Auth::logout() 方法来实现用户的退出功能。

四、使用隐藏域来伪造 DELETE 请求

退出登录：Auth::logout();

在做登录退出操作时，需要删除用户的登录信息,如下表单：

{{ csrf_field() }}

{{ method_field('DELETE') }}

退出

可以看到用户退出登录的按钮实际上是一个表单的提交按钮，在点击退出按钮之后浏览器将向 /logout 地址发送一个 POST 请求。但由于 RESTful 架构中会使用 DELETE 请求来删除一个资源，当用户退出时，实际上相当于删除了用户登录会话的资源，因此这里的退出操作需要使用 DELETE 请求来发送给服务器。由于浏览器不支持发送 DELETE 请求，因此我们需要使用一个隐藏域来伪造 DELETE 请求。

在 Blade 模板中，我们可以使用 method_field 方法来创建隐藏域。

{{ method_field('DELETE') }}

其转化为 HTML 代码如下：