Laravel 用户注册登录功能

作者：: truesnow
发布于：: 7年前
收录于：: 个人网站开发
: 2112 0

摘要：# 1. 用户数据库迁移 Laravel 在 *database/migrations* 目录下有默认的用户表 `users` 和密码重置表 `password_resets` 迁移文件。执行迁移： ``` php artisan migrate ``` 第一次执行迁移后会在数据库中...

# 1. 用户数据库迁移

Laravel 在 *database/migrations* 目录下有默认的用户表 `users` 和 密码重置表 `password_resets` 迁移文件。

执行迁移：

```
php artisan migrate
```

第一次执行迁移后会在数据库中生成一个 `migrations` 表，用于记录迁移历史、回滚迁移。

# 2. 用户模型

Laravel 默认生成了用户模型 *app/User.php*。

模型表中几个属性说明：

```
// 表名
protected $table = 'users';

// 可更新字段
protected $fillable = ['name', 'email', 'password'];

// 隐藏敏感字段
protected $hidden = ['password', 'remember_token'];
```

## 2.1. 迁移 *App\User* 到 *App\Models\User*

为了统一，将用户模型文件迁移到 *app/Models* 目录下，同时全局搜索将 *App\User* 命名空间替换为 *App\Models\User*，并提交到 Git。

## 2.2. 使用 Gravatar 头像

- [Gravatar - 全球通用头像](https://en.gravatar.com/)

在 *app/Models/User.php* 中新增方法生成 Gravatar 头像：

```
    public function gravatar($size = '100')
    {
        $hash = md5(strtolower(trim($this->attributes['email'])));
        return "http://s.gravatar.com/avatar/$hash?s=$size";
    }
```

在页面中获取：

```
{{ $user->gravatar() }}
```

# 3. 用户资源路由

在 *app/routes/web.php* 中注册用户资源路由：

```
Route::resource('users', 'UsersController');
```

代码等同于：

```
Route::get('/users', 'UsersController@index')->name('users.index');
Route::get('/users/{user}', 'UsersController@show')->name('users.show');
Route::get('/users/create', 'UsersController@create')->name('users.create');
Route::post('/users', 'UsersController@store')->name('users.store');
Route::get('/users/{user}/edit', 'UsersController@edit')->name('users.edit');
Route::patch('/users/{user}', 'UsersController@update')->name('users.update');
Route::delete('/users/{user}', 'UsersController@destroy')->name('users.destroy');
```

`resource` 方法按照 RESTful 架构设计路由：

![](http://pb8quxvbv.bkt.clouddn.com/images/201807/YVEll6K5Sm6UMed.png)

# 4. 页面公共模板
## 4.1. 显示表单错误信息
将表单错误信息写成公共模板：*resources/views/shared/_errors.blade.php*，通过检测页面模板 `$errors` 变量来显示表单错误信息：

```
@if (count($errors) > 0)
  <div class="alert alert-danger">
      <ul>
          @foreach($errors->all() as $error)
          <li>{{ $error }}</li>
          @endforeach
      </ul>
  </div>
@endif
```

然后在页面中引用：

```
@include('shared._errors')
```

默认情况下显示的是英文信息，可通过 *resources/lang/xx/validation.php* 添加语言包，并在 `csutom` 数组中对翻译语言进行设定。如：

```
'custom' => [
    'email' => [
        'required' => '邮箱地址不能为空！',
    ],
],
```

使用扩展包：

```
composer require "overtrue/laravel-lang:~3.0"
```

将语言设置为中文 *config/app.php*：

```
'locale' => 'zh-CN'
```

查看使用说明：https://github.com/overtrue/laravel-lang/blob/master/README_CN.md

![](http://pb8quxvbv.bkt.clouddn.com/images/201807/xTIJTTQvCaHIf0H.png)

## 4.2. 消息提示公用模板
通过在控制器中一次性写 session，在渲染页面时读取 session 中的值来显示提示信息。

*resources/views/shared/_messages.blade.php*：

```
@foreach (['danger', 'warning', 'success', 'info'] as $msg)
  @if(session()->has($msg))
    <div class="flash-message">
      <p class="alert alert-{{ $msg }}">
        {{ session()->get($msg) }}
      </p>
    </div>
  @endif
@endforeach
```

可在全局视图中加入：

```
@include('shared._messages')
```

控制器：

```
session()->flash('success', '成功删除用户！');
// 或
return redirect()->route('/')->with('success', '操作成功');
```

![](http://pb8quxvbv.bkt.clouddn.com/images/201807/w0G7vWGSJn49GeI.png)

## 4.3. 模板语法
`{{ old('name') }}` 自动填写上最后一次输入过的数据。
`{{ csrf_field() }}` 生成 `csrf_field`。转换成 HTML 为：

```
<input type="hidden" name="_token" value="34LxFDYsHYTOKnpC8wrINE2i4k7Nh9VluBqopFZo">
```

`{{ method_field('DELETE') }}`：创建 HTTP 方法隐藏域，转换成 HTML 为：

```
<input type="hidden" name="_method" value="DELETE">
```

`@can` 授权检测：

```
@can('destroy', $user)
```

# 5. 用户注册

## 5.1. 页面

页面中注册表单包含：name、email、password、password_confirmation 字段。

![](http://pb8quxvbv.bkt.clouddn.com/images/201807/FYDUT756gmH0Nu3.png)

## 5.2. 控制器
在 *app/Http/Controllers/UsersController.php* 中完成路由动作方法。如果找不到相应资源会返回 `404` 响应。
知识点：

- [隐性路由模型绑定](http://d.laravel-china.org/docs/5.5/routing#%E9%9A%90%E5%BC%8F%E7%BB%91%E5%AE%9A)

- 控制器中表单验证

```

- 保存用户并重定向

```
public function store(Request $request)
    {
        $this->validate($request, [
            'name' => 'required|max:50',
            'email' => 'required|email|unique:users|max:255',
            'password' => 'required|confirmed|min:6'
        ]);
        $user = User::create([
            'name' => $request->name,
            'email' => $request->email,
            'password' => bcrypt($request->password),
        ]);

session()->flash('success', '欢迎，您将在这里开启一段新的旅程~');
        return redirect()->route('users.show', [$user]);
    }

```

# 6. 会话管理

生成会话管理控制器：

```
php artisan make:controller SessionsController
```

路由：

```
Route::get('login', 'SessionsController@create')->name('login');
Route::post('login', 'SessionsController@store')->name('login');
Route::delete('logout', 'SessionsController@destroy')->name('logout');

```

## 6.1. 登录

创建登录页面，写控制器登录代码：

```
    public function create()
    {
        return view('sessions.create');
    }
    public function store(Request $request)
    {
        $credentials = $this->validate($request, [
            'email' => 'required|email|max:255',
            'password' => 'required',
        ]);
        if (Auth::attempt($credentials, $request->has('remember'))) {
            if (Auth::user()->activated) {
                session()->flash('success', '欢迎回来！');
                return redirect()->intended(route('home'));
            } else {
                Auth::logout();
                session()->flash('warning', '您的账号未激活，请检查邮箱中的注册邮件进行激活。');
                return redirect('/');
            }
        } else {
            session()->flash('danger', '抱歉，您的邮箱和密码不匹配');
            return redirect()->back();
        }
    }

```

![](http://pb8quxvbv.bkt.clouddn.com/images/201807/hqIiwUy6Ivca0l0.png)

## 6.2. 退出登录

```
    public function destroy()
    {
        Auth::logout();
        session()->flash('success', '退出登录成功');
        return redirect('login');
    }

```

![](http://pb8quxvbv.bkt.clouddn.com/images/201807/XUqU4tjRtPMKEVo.png)

## 6.3. Auth

- `Auth::check()`：检测用户是否登录

- `Auth::login($user)`：用户登录

- `Auth::logout()`：注销

- `Auth::attempt($credentials, $is_remember)`：尝试登录

# 7. 权限系统

在未进行严格权限限制时，未登录用户可以编辑用户；登录用户可以更新其它用户的个人信息。

Laravel 提供了 `Auth` 中间件来进行权限控制，中间件都在 *app/Http/Middleware* 目录下。

*app/Http/Controllers/UsersController.php*：

```
    public function __construct()
    {
        $this->middleware('auth', [

// 无需登录即可访问     
            'except' => ['show', 'create', 'store']
        ]);
    }

```

其次当 id 为 2 的用户更新 id 为 1 的用户资料时，返回 403 异常。Laravel 提供了 [授权策略](http://d.laravel-china.org/docs/5.5/authorization#policies) 来验证。

生成用户授权策略：

```
php artisan make:policy UserPolicy
```

所有策略文件都在 *app/Policies* 目录下。

```

<?php
namespace App\Policies;
use Illuminate\Auth\Access\HandlesAuthorization;
use App\Models\User;
class UserPolicy
{
    use HandlesAuthorization;
    public function update(User $currentUser, User $user)
    {
        return $currentUser->id === $user->id;
    }
}

```

`update` 接收两个参数，第一个为当前登录用户实例，第二个为要进行授权的用户实例。id 相同则表示是同一用户，可以啊哦做，id 不同，则抛出 403 异常拒绝访问。默认不需要传当前登录用户，框架会自动加载当前登录用户。

然后在需要为用户模型绑定授权策略：

*app/Providers/AuthServiceProvider.php*

```
<?php
namespace App\Providers;
.
,
.
class AuthServiceProvider extends ServiceProvider
{
    /**
     * The policy mappings for the application.
     *
     * @var array
     */
    protected $policies = [
        'App\Model' => 'App\Policies\ModelPolicy',
        \App\Models\User::class => \App\Policies\UserPolicy::class,
    ];
    .
    .
    .
}

```

定义后可用 `authorize` 方法验证。`AuthorizesRequests` trait 提供。

```
$this->authorize('update', $user);
```

- 已登录用户不可访问登录页面

```
    public function __construct()
    {
        $this->middleware('guest', [
            'only' => ['create']
        ]);
    }

```

- 未登录用户只可访问注册页

```
    public function __construct()
    {
        $this->middleware('auth', [
            'except' => ['show', 'create', 'store']
        ]);
        $this->middleware('guest', [
            'only' => ['create']
        ]);
    }

```

- 已登录用户重定向页面修改

`app/Http/Middleware/RedirectIfAuthenticated.php`

```
<?php
.
.
.
class RedirectIfAuthenticated
{
    .
    .
    .
    public function handle($request, Closure $next, $guard = null)
    {
        if (Auth::guard($guard)->check()) {
            session()->flash('info', '您已登录，无需再次操作。');
            return redirect('/');
        }
        .
        .
        .
    }
}

```

# 8. 响应处理

- 登录后响应到用户尝试访问的链接：

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

- 响应到请求链接：

```
return redirect()->back();
```

- 响应到主页

```
return redirect('/');
```

- 重定向到路由

```
return redirect()->route('users.show', $user->id)->with('success', '更新密码成功！');
```

# 9. 数据填充

假数据的生成分为两个阶段：
- 对要生成假数据的模型指定字段进行赋值 - [『模型工厂』](http://d.laravel-china.org/docs/5.5/testing#model-factories)；

- 批量生成假数据模型 - [『数据填充』](http://d.laravel-china.org/docs/5.5/seeding)；

`database/factories/UserFactory.php`

```
<?php
use Faker\Generator as Faker;
/*
|--------------------------------------------------------------------------
| Model Factories
|--------------------------------------------------------------------------
|
| This directory should contain each of the model factory definitions for
| your application. Factories provide a convenient way to generate new
| model instances for testing / seeding your application's database.
|
*/
$factory->define(App\Models\User::class, function (Faker $faker) {
    $date_time = $faker->date . ' ' . $faker->time;
    static $password;
    return [
        'name' => $faker->name,
        'email' => $faker->safeEmail,
        'password' => $password ?: $password = bcrypt('secret'),
        'remember_token' => str_random(10),
        'created_at' => $date_time,
        'updated_at' => $date_time,
    ];
});

```

数据填充：

```
php artisan make:seeder UsersTableSeeder

```

*database/seeds/UsersTableSeeder.php*

```
<?php
use Illuminate\Database\Seeder;
use App\Models\User;
class UsersTableSeeder extends Seeder
{
    /**
     * Run the database seeds.
     *
     * @return void
     */
    public function run()
    {
        $users = factory(User::class)->times(50)->make();
        User::insert($users->makeVisible(['password', 'remember_token'])->toArray());
        $user = User::find(1);
        $user->name = 'Aufree';
        $user->email = 'aufree@yousails.com';
        $user->password = bcrypt('password');
        $user->save();
    }
}

```

调用注册：

*database/seeds/DatabaseSeeder.php*

```
<?php
use Illuminate\Database\Seeder;
use Illuminate\Database\Eloquent\Model;
class DatabaseSeeder extends Seeder
{
    /**
     * Run the database seeds.
     *
     * @return void
     */
    public function run()
    {
        Model::unguard();
        $this->call(UsersTableSeeder::class);
        Model::reguard();
    }
}

```

执行：

```
$ php artisan migrate:refresh
$ php artisan db:seed

```

```
$ php artisan migrate:refresh
$ php artisan db:seed --class=UsersTableSeeder

```

```
$ php artisan migrate:refresh --seed

```

# 10. 分页

```
$users = User::paginate(10);

```

```
{!! $users->render() !!}

```

# 11. 管理员设置

添加 `is_admin` 字段：

```
php artisan make:migration add_is_admin_to_users_table --table=users

```

```
$table->boolean('is_admin')->default(false);

```

*app/Policies/UserPolicy*

```
    public function destroy(User $currentUser, User $user)
    {
        return $currentUser->is_admin && $currentUser->id !== $user->id;
    }

```

# 12. 账户激活

```
php artisan make:migration add_activation_to_users_table --table=users

```

```
            $table->string('activation_token')->nullable();
            $table->boolean('activated')->default(false);

```

```
php artisan migrate

```

用户模型创建事件生成激活码：

```
<?php
namespace App\Models;
.
.
.
class User extends Authenticatable
{
    .
    .
    .
    protected $hidden = ['password', 'remember_token'];
    public static function boot()
    {
        parent::boot();
        static::creating(function ($user) {
            $user->activation_token = str_random(30);
        });
    }
    .
    .
    .
}

```

激活路由：*http://sample.app/signup/confirm/O1TTEr3faVq4fpzFXaOVQD4EAO9mQL*

```
Route::get('signup/confirm/{token}', 'UsersController@confirmEmail')->name('confirm_email');

```

邮件模板页面：*resources/views/emails/confirm.blade.php*

```
<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <title>注册确认链接</title>
</head>
<body>
  <h1>感谢您在 Sample 网站进行注册！</h1>
  <p>
    请点击下面的链接完成注册：
    <a href="{{ route('confirm_email', $user->activation_token) }}">
      {{ route('confirm_email', $user->activation_token) }}
    </a>
  </p>
  <p>
    如果这不是您本人的操作，请忽略此邮件。
  </p>
</body>
</html>

```

登录时加入是否激活验证。

```
<?php
namespace App\Http\Controllers;
.
.
.
class SessionsController extends Controller
{
    .
    .
    .
    public function store(Request $request)
    {
       $credentials = $this->validate($request, [
           'email' => 'required|email|max:255',
           'password' => 'required'
       ]);
       if (Auth::attempt($credentials, $request->has('remember'))) {
           if(Auth::user()->activated) {
               session()->flash('success', '欢迎回来！');
               return redirect()->intended(route('users.show', [Auth::user()]));
           } else {
               Auth::logout();
               session()->flash('warning', '你的账号未激活，请检查邮箱中的注册邮件进行激活。');
               return redirect('/');
           }
       } else {
           session()->flash('danger', '很抱歉，您的邮箱和密码不匹配');
           return redirect()->back();
       }
    }
    .
    .
    .
}

```

发送邮件：

```
    protected function sendEmailConfirmationTo($user)
    {
        $view = 'emails.confirm';
        $data = compact('user');
        $from = 'aufree@yousails.com';
        $name = 'Aufree';
        $to = $user->email;
        $subject = "感谢注册 Sample 应用！请确认你的邮箱。";
        Mail::send($view, $data, function ($message) use ($from, $name, $to, $subject) {
            $message->from($from, $name)->to($to)->subject($subject);
        });
    }

```

激活：

```
    public function confirmEmail($token)
    {
        $user = User::where('activation_token', $token)->firstOrFail();
        $user->activated = true;
        $user->activation_token = null;
        $user->save();
        Auth::login($user);
        session()->flash('success', '恭喜你，激活成功！');
        return redirect()->route('users.show', [$user]);
    }

```

# 13. 密码重设

重设密码路由：

```
Route::get('password/reset', 'Auth\ForgotPasswordController@showLinkRequestForm')->name('password.request');
Route::post('password/email', 'Auth\ForgotPasswordController@sendResetLinkEmail')->name('password.email');
Route::get('password/reset/{token}', 'Auth\ResetPasswordController@showResetForm')->name('password.reset');
Route::post('password/reset', 'Auth\ResetPasswordController@reset')->name('password.update');

```

后台 Laravel 已提供，只需创建视图。

生成消息通知文件：

```
php artisan make:notification ResetPassword

```

以上命令会生成 *app/Notifications/ResetPassword.php* 文件。

`User` 模型里调用：

```
<?php
namespace App\Models;
.
.
.
use App\Notifications\ResetPassword;
class User extends Authenticatable
{
    .
    .
    .
    public function sendPasswordResetNotification($token)
    {
        $this->notify(new ResetPassword($token));
    }
}

```

发布密码重置的 Email 视图；

```
php artisan vendor:publish --tag=laravel-notifications

```

发布的文件为 *resources/views/vendor/notifications/email.blade.php*。

![](http://pb8quxvbv.bkt.clouddn.com/images/201807/OwiVSqmKHjgWIBt.png)

![](http://pb8quxvbv.bkt.clouddn.com/images/201807/0mSVtZ1q1yIUofq.png)

# 14. 自动加载自定义帮助函数文件

新建 */bootstrap/helpers.php*：

```
<?php
/**
 * 将当前页面路由名称中的 `.` 替换为 `-`，作为当前视图页面 class
 * @return string 路由视图 class 名称
 */
function route_class()
{
    return str_replace('.', '-', Route::currentRouteName());
}

```

在 */bootstrap/app.php* 中引入：

```
require_once __DIR__ . '/helpers.php';

```

文章目录

Laravel 用户注册登录功能

所有评论（0）