本教程详细指导如何在 laravel 8 框架中，将默认的用户认证方式从邮箱（email）切换为用户名（username）。通过重写 `logincontroller` 中的 `username()` 方法，并确保前端登录表单和数据库用户表结构与此更改同步，开发者可以轻松实现基于用户名的登录功能，提升应用的灵活性。
Laravel 框架以其强大的认证系统而闻名，开箱即用地提供了基于邮箱和密码的用户登录功能。然而，在实际项目开发中，开发者常常需要根据业务需求调整认证凭据，例如使用用户名（username）而非邮箱进行登录。当默认的认证机制不满足需求时，理解其内部工作原理并进行适当的定制变得尤为重要。本教程将深入探讨如何在 Laravel 8 中实现这一常见的定制化需求，将默认的邮箱认证切换为用户名认证。
Laravel 的认证功能主要通过 Illuminate\Foundation\Auth\AuthenticatesUsers Trait 来实现。这个 Trait 内部包含了一个 username() 方法，它负责返回用于用户认证的字段名称。默认情况下，这个方法返回 'email'，这意味着 Laravel 会尝试使用用户提交的邮箱地址与数据库中的 email 字段进行匹配。
当开发者在前端登录表单中将输入字段的 name 属性从 email 修改为 name（或任何其他字段，如 username）时，如果后端没有同步进行相应的修改，认证过程将无法正确匹配用户。尽管注册功能可能正常工作，因为注册通常是独立处理用户数据的保存，但登录时由于认证字段不匹配，会导致用户无法成功登录。
解决这个问题的关键在于告知 Laravel 认证系统，它应该使用哪个字段来查找用户。这可以通过在 LoginController 中重写 AuthenticatesUsers Trait 提供的 username() 方法来实现。
通过在 LoginController 中添加一个 username() 方法并使其返回 'name'，我们明确指示 Laravel 使用请求中名为 name 的字段作为认证凭据。
在 app/Http/Controllers/Auth/LoginController.php 文件中，添加或修改 username() 方法如下：
<?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;
/**
* Where to redirect users after login.
*
* @var string
*/
protected $redirectTo = RouteServiceProvider::HOME;
/**
* Create a new controller instance.
*
* @return void
*/
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'
}
}在重写 username() 方法之前，必须确保以下前置条件已满足：
您的 users 表必须包含一个用于存储用户名的字段，且该字段应具有唯一性约束，以避免不同用户使用相同用户名导致认证冲突。
请检查您的用户迁移文件（例如 database/migrations/xxxx_xx_xx_create_users_table.php），确保其中包含一个 name 字段，并且最好设置为 unique()：
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
class CreateUsersTable extends Migration
{
/**
* Run the migrations.
*
* @return void
*/
public function up()
{
Schema::create('users', function (Blueprint $table) {
$table->id();
$table->string('name')->nullable()->unique(); // 确保有此行，且最好是唯一的
// ... 其他字段 ...
$table->string('password');
$table->rememberToken();
$table->timestamps();
});
}
/**
* Reverse the migrations.
*
* @return void
*/
public function down()
{
Schema::dropIfExists('users');
}
}确保您的登录视图 (resources/views/auth/login.blade.php) 和注册视图 (resources/views/auth/register.blade.php) 中，用于输入用户名的 input 字段的 name 属性与您在 username() 方法中指定的字段名（即 'name'）一致。
登录视图 (login.blade.php) 示例：
<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">
<input id="name" type="text" class="form-control @error('name') is-invalid @enderror" name="name" value="{{ old('name') }}" required autocomplete="name" autofocus>
@error('name')
<span class="invalid-feedback" role="alert">
<strong>{{ $message }}</strong>
</span>
@enderror
</div>
</div>注册视图 (register.blade.php) 示例：
<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">
<input id="name" type="text" class="form-control @error('name') is-invalid @enderror" name="name" value="{{ old('name') }}" required autocomplete="name" autofocus>
@error('name')
<span class="invalid-feedback" role="alert">
<strong>{{ $message }}</strong>
</span>
@enderror
</div>
</div>通过在 LoginController 中简单地重写 username() 方法，并确保前端视图和数据库表结构与此更改保持同步，您可以轻松地将 Laravel 默认的邮箱认证切换为用户名认证。这种灵活性是 Laravel 框架强大之处的体现，它允许开发者根据具体的应用需求，定制和扩展核心功能。遵循本教程的步骤和注意事项，您将能够成功地实现基于用户名的自定义登录功能，为您的 Laravel 应用提供更符合业务逻辑的用户认证体验。
以上就是Laravel 8 自定义登录：将默认邮箱认证切换为用户名认证的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
881
收藏
