Laravel 5.3 用户验证源码探究 (一) 路由与注册
https://blog.csdn.net/realghost/article/details/52558962
简介
Laravel 从 5.2 开始就有了开箱即用的用户验证,5.3 又在 5.2 的基础上又有了一些改变。为了深入了解具体的用户验证实现,只能深入 Laravel 的源码,探究用户验证是怎么处理的。
开始
安装好 Laravel 5.3 的框架后,执行下面的命令
php artisan make:auth
该命令会在项目里添加以下文件(目录)
app/Http/Controller/HomeController.php resources/views/auth/ resources/views/auth/login.blade.php resources/views/auth/passwords/ resources/views/auth/passwords/email.blade.php resources/views/auth/passwords/reset.blade.php resources/views/auth/register.blade.php resources/views/home.blade.php resources/views/layouts/ resources/views/layouts/app.blade.php
除了一个 HomeController
是处理用户登陆之后的逻辑,其他都是一些视图,用于显示相应的页面。
在 routes/web.php
里添加了以下内容
Auth::routes();
Route::get(‘/home’, ‘HomeController@index’);
Auth::routes()
是登陆、注册需要的一些路由;下面是定义一个 /home
路由,交给 HomeController@index
处理。
那么,就从路由开始我们的探究之旅吧。
路由
我们首先看看 Auth::routes()
,定义在 vendor/laravel/framework/src/Illuminate/Support/Facades/Auth.php
:
public static function routes() { static::$app->make('router')->auth(); }
这里由 IoC 容器 解析了一个 Illuminate\Routing\Router 类的实例,再调用里面的 auth()
方法。
我们再来看看 auth() 方法,定义在 vendor/laravel/framework/src/Illuminate/Routing/Router.php
:
public function auth() { // Authentication Routes... $this->get('login', 'Auth\LoginController@showLoginForm')->name('login'); $this->post('login', 'Auth\LoginController@login'); $this->post('logout', 'Auth\LoginController@logout'); // Registration Routes... $this->get('register', 'Auth\RegisterController@showRegistrationForm'); $this->post('register', 'Auth\RegisterController@register'); // Password Reset Routes... $this->get('password/reset', 'Auth\ForgotPasswordController@showLinkRequestForm'); $this->post('password/email', 'Auth\ForgotPasswordController@sendResetLinkEmail'); $this->get('password/reset/{token}', 'Auth\ResetPasswordController@showResetForm'); $this->post('password/reset', 'Auth\ResetPasswordController@reset'); }
这里定义了 登陆 、 注销 、注册 和 密码重置 的路由。
先看看注册部分。
注册
App\Http\Controllers\Auth\RegisterController
负责注册的逻辑,这里 use 了 Illuminate\Foundation\Auth\RegistersUsers
这个 trait ,包含注册时通用的一些逻辑。
路由 get('/register')
所绑定的方法 Auth\RegisterController@showRegistrationForm
就定义在这个 trait 里:
public function showRegistrationForm()
{
return view('auth.register');
}
很简单,返回一个 auth.register
视图。
auth.register
视图获取用户的输入: name
,email
,password
,然后 POST 提交到 ‘/register’。
再来看看路由 post('/register')
所绑定的方法 Auth\RegisterController@register
。
同样, register
方法定义在 Illuminate\Foundation\Auth\RegistersUsers
里:
public function register(Request $request)
{
$this->validator($request->all())->validate();
$this->guard()->login($this->create($request->all()));
return redirect($this->redirectPath());
}
首先使用请求传入的表单调用 validator()
,返回一个验证对象,再调用 validate()
验证表单内容的合法性。
validator()
定义在 App\Http\Controllers\Auth\RegisterController
里:
protected function validator(array $data)
{
return Validator::make($data, [
'name' => 'required|max:255',
'email' => 'required|email|max:255|unique:users',
'password' => 'required|min:6|confirmed',
]);
}
在这里给出了输入表单的验证规则,如果我们的用户注册需要的表单与这几个字段不一致(例如需要添加一个手机号),就在这里修改。
返回的 Validator
对象会在 register()
方法里验证。
再回到 register()
方法, 往下走 $this->guard()->login($this->create($request->all()));
。
$this->guard()
这里会调用 Illuminate\Foundation\Auth\RegistersUsers
里的 guard()
:
protected function guard()
{
return Auth::guard();
}
这里无参数调用 Auth::guard()
返回一个默认的 guard ,看一下 config/auth.php
:
'defaults' => [
'guard' => 'web',
'passwords' => 'users',
],
'guards' => [
'web' => [
'driver' => 'session',
'provider' => 'users',
],
'api' => [
'driver' => 'token',
'provider' => 'users',
],
],
'providers' => [
'users' => [
'driver' => 'eloquent',
'model' => App\User::class,
],
],
默认的 guard 是 web ; web 这个 guard 采用 session 驱动, 数据提供者是 users ;users 数据提供者使用 eloquent 驱动, 使用 App\User::class
模型。
具体这个 guard 是怎么生成的,这里暂时先不探究,放到登陆验证里再详细说明。
接下来调用 guard 的 login($this->create($request->all()))
。
首先是 $this->create()
,这个方法定义在 App\Http\Controllers\Auth\RegisterController
里:
protected function create(array $data)
{
return User::create([
'name' => $data['name'],
'email' => $data['email'],
'password' => bcrypt($data['password']),
]);
}
使用 User
模型对输入的内容新增一条记录,并返回这个模型的对象。
同样,如果需要修改注册时使用的字段,也是改写这个方法。
生成的 User
对象交给 guard 的 login()
方法,做一系列登录的操作,具体怎么做的,还是放到登陆验证里再详细说明。
最后, return redirect($this->redirectPath());
完成了注册、登陆的操作,最后跳转到我们在 App\Http\Controllers\Auth\RegisterController
里设置的 protected $redirectTo = '/home';
目标 URI。
可以看一下 $this->redirectPath()
方法怎么写的,在 Illuminate\Foundation\Auth\RedirectsUsers
这个 trait 里:
public function redirectPath() { return property_exists($this, 'redirectTo') ? $this->redirectTo : '/home'; }
如果定义了 $redirectTo 这个属性,就按照这个属性返回;如果没有,返回 ‘/home’。
这里把这个方法写成 trait 是因为这个方法还会在
App\Http\Controllers\Auth\LoginController
登陆控制器里使用,所以就把redirectPath()
这个方法提出来做成一个 trait ,严格遵守 DRY 原则。
到这里,就完成了注册的所有过程。
赞赏码
![](https://files.cnblogs.com/files/lxwphp/zhifubao2.bmp)
![](https://files.cnblogs.com/files/lxwphp/weixin.bmp)
非学,无以致疑;非问,无以广识