Laravel8自定义登录：用用户名认证替代邮箱

**Laravel 8 自定义登录：用用户名替代邮箱认证** 想要提升用户体验，摆脱传统的邮箱登录方式吗？本文详细讲解如何在 Laravel 8 中实现自定义登录，将默认的邮箱认证改为使用用户名进行身份验证。通过重写 `LoginController` 中的 `username()` 方法，并配合数据库和视图的相应调整，即可轻松完成配置。本文将引导你完成数据库字段的修改、User 模型的更新、登录控制器和视图的调整等关键步骤，确保你的 Laravel 应用能够使用用户名进行安全、便捷的登录验证。无论你是 Laravel 新手还是经验丰富的开发者，都能从中受益，让你的应用更具个性化和灵活性。

本教程详细介绍了如何在 Laravel 8 应用程序中，将默认的基于邮箱的登录方式修改为使用用户名进行身份验证。通过重写 `LoginController` 中的 `username()` 方法，并确保视图和数据库配置正确，开发者可以轻松实现自定义登录字段，从而提升用户体验并增强系统的灵活性。

理解 Laravel 默认认证机制

Laravel 框架提供了一套强大且易于使用的认证系统。默认情况下，该系统基于用户的邮箱地址进行身份验证。当用户尝试登录时，框架会查找数据库中与所提供邮箱匹配的用户记录。然而，在许多应用场景中，开发者可能希望使用用户名、手机号或其他唯一标识符作为登录凭据。

Laravel 的认证逻辑主要通过 Illuminate\Foundation\Auth\AuthenticatesUsers trait 实现，该 trait 被 LoginController 引用。这个 trait 内部包含了一个 username() 方法，用于定义登录时使用的字段名。默认情况下，这个方法返回 'email'。

定制登录字段为用户名

要将 Laravel 8 的登录机制从邮箱切换为用户名（或其他字段），核心步骤是重写 LoginController 中的 username() 方法。此外，还需要确保前端视图和数据库层面也做了相应的调整。

1. 检查数据库 users 表结构

首先，请确保您的 users 表中包含一个用于存储用户名的字段。通常，这个字段名为 name。为了确保登录的唯一性，建议将此字段设置为 unique。

// database/migrations/xxxx_xx_xx_xxxxxx_create_users_table.php
Schema::create('users', function (Blueprint $table) {
    $table->id();
    $table->string('name')->nullable()->unique(); // 确保 'name' 字段存在且唯一
    // ... 其他字段
    $table->string('password');
    $table->rememberToken();
    $table->timestamps();
});

如果您的 name 字段不是唯一的，可能导致登录时出现意外行为，因为系统可能匹配到多条记录。

2. 更新 User 模型

确保 App\Models\User 模型中的 $fillable 数组包含 name 字段，以便在注册时可以批量赋值。

// app/Models/User.php
namespace App\Models;

use Illuminate\Contracts\Auth\MustVerifyEmail;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Laravel\Sanctum\HasApiTokens;

class User extends Authenticatable
{
    use HasApiTokens, HasFactory, Notifiable;

    protected $fillable = [
        'name', // 确保 'name' 字段在这里
        'password',
        // ... 其他可填充字段
    ];

    protected $hidden = [
        'password',
        'remember_token',
    ];
}

3. 修改登录控制器 LoginController

这是实现自定义登录字段的关键步骤。您需要重写 LoginController 中的 username() 方法，使其返回您希望用于登录的字段名，这里是 'name'。

// app/Http/Controllers/Auth/LoginController.php
namespace App\Http\Controllers\Auth;

use App\Http\Controllers\Controller;
use App\Providers\RouteServiceProvider;
use Illuminate\Foundation\Auth\AuthenticatesUsers;

class LoginController extends Controller
{
    use AuthenticatesUsers;

    protected $redirectTo = RouteServiceProvider::HOME;

    public function __construct()
    {
        $this->middleware('guest')->except('logout');
    }

    /**
     * Get the login username to be used by the controller.
     *
     * @return string
     */
    public function username()
    {
        return 'name'; // 将默认的 'email' 修改为 'name'
    }
}

通过添加这个方法，AuthenticatesUsers trait 在执行认证逻辑时，会调用此方法来获取用于查找用户的字段名，从而实现使用用户名登录。

4. 更新登录视图 login.blade.php

确保您的登录表单视图中，用于输入用户名的 input 字段的 name 属性为 name。

<!-- resources/views/auth/login.blade.php -->
<form method="POST" action="{{ route('login') }}">
    @csrf

    <div class="form-group row">
        <label for="name" class="col-md-4 col-form-label text-md-right">{{ __('Username') }}</label>

        <div class="col-md-6">
            &lt;input id=&quot;name&quot; type=&quot;text&quot; class=&quot;form-control @error(&apos;name&apos;) is-invalid @enderror&quot; name=&quot;name&quot; value=&quot;{{ old(&apos;name&apos;) }}&quot; required autocomplete=&quot;name&quot; autofocus&gt;

            @error('name')
                <span class="invalid-feedback" role="alert">
                    <strong>{{ $message }}</strong>
                </span>
            @enderror
        </div>
    </div>

    <div class="form-group row">
        <label for="password" class="col-md-4 col-form-label text-md-right">{{ __('Password') }}</label>
        <div class="col-md-6">
            &lt;input id=&quot;password&quot; type=&quot;password&quot; class=&quot;form-control @error(&apos;password&apos;) is-invalid @enderror&quot; name=&quot;password&quot; required autocomplete=&quot;current-password&quot;&gt;
            @error('password')
                <span class="invalid-feedback" role="alert">
                    <strong>{{ $message }}</strong>
                </span>
            @enderror
        </div>
    </div>

    <!-- ... 其他表单元素 -->
</form>

请注意，id 属性和 label 的 for 属性可以保持不变或根据需要修改，但关键是 input 标签的 name="name"。

5. 更新注册视图 register.blade.php (可选但推荐)

如果您的注册表单也需要收集用户名，请确保相应的 input 字段的 name 属性也设置为 name。

<!-- resources/views/auth/register.blade.php -->
<form method="POST" action="{{ route('register') }}">
    @csrf

    <div class="form-group row">
        <label for="name" class="col-md-4 col-form-label text-md-right">{{ __('Username') }}</label>

        <div class="col-md-6">
            &lt;input id=&quot;name&quot; type=&quot;text&quot; class=&quot;form-control @error(&apos;name&apos;) is-invalid @enderror&quot; name=&quot;name&quot; value=&quot;{{ old(&apos;name&apos;) }}&quot; required autocomplete=&quot;name&quot; autofocus&gt;

            @error('name')
                <span class="invalid-feedback" role="alert">
                    <strong>{{ $message }}</strong>
                </span>
            @enderror
        </div>
    </div>

    <!-- ... 其他注册字段，包括密码 -->
</form>

注意事项与总结

• 字段唯一性： 用于登录的字段（如 name）在数据库中必须是唯一的，否则认证系统可能无法确定要登录哪个用户。
• 验证规则： 如果您希望对 name 字段进行额外的验证（例如长度限制、字符类型等），可以在 LoginController 中重写 validateLogin() 方法或使用自定义请求类。
• 注册流程： 确保注册逻辑也正确地处理 name 字段，并将其保存到数据库中。
• Laravel UI / Breeze / Jetstream： 本教程适用于使用 Laravel UI 或类似认证脚手架的项目。如果您使用的是 Breeze 或 Jetstream，其认证逻辑可能略有不同，但核心原理（重写 username() 方法）通常是相同的。

通过以上步骤，您已经成功地将 Laravel 8 应用程序的登录方式从默认的邮箱认证切换到了用户名认证。这种方法简单高效，是定制 Laravel 认证行为的常用实践。

好了，本文到此结束，带大家了解了《Laravel8自定义登录：用用户名认证替代邮箱》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！