本教程详细介绍了如何在 laravel 8 应用程序中，将默认的用户登录认证机制从使用邮箱改为使用用户名。核心步骤是通过重写 `logincontroller` 中的 `username()` 方法，指定以 `name` 字段作为认证凭据，从而实现基于用户名的灵活登录。
Laravel 框架为用户认证提供了强大且开箱即用的支持。默认情况下，Laravel 的认证系统使用用户的 email 字段作为登录凭据。然而，在许多应用场景中，开发者可能需要使用其他字段，例如 username（或 name）来进行用户登录。本教程将指导您如何在 Laravel 8 项目中，轻松地将默认的邮箱认证机制修改为基于用户名的认证。
Laravel 的认证功能主要通过 Illuminate\Foundation\Auth\AuthenticatesUsers Trait 实现。这个 Trait 包含了处理用户登录、注销等逻辑的核心方法。其中，决定登录凭据字段的关键方法是 username()。默认情况下，此方法返回 'email'，指示系统使用 email 字段进行认证。
如果您在 login.blade.php 视图文件中将登录字段从 email 修改为 name，但未在控制器层面进行相应配置，系统仍会尝试使用 email 进行认证，导致登录失败。
要将登录认证字段从 email 切换到 name，我们需要进行以下调整：
首先，请确保您的 users 表中包含一个用于用户名的字段，例如 name，并且该字段应具备唯一性约束，以避免登录冲突。
// database/migrations/xxxx_xx_xx_xxxxxx_create_users_table.php
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(); // 确保 'name' 字段存在且唯一
$table->string('education')->nullable();
$table->string('sponsor')->nullable();
$table->string('telegram')->unique();
$table->boolean('is_admin')->default(0);
$table->text('skills')->nullable();
$table->boolean('is_deleted')->default(0);
$table->boolean('is_verified')->default(0);
$table->boolean('is_banned')->default(0);
$table->integer('rank')->default(0);
$table->string('password');
$table->rememberToken();
$table->timestamps();
});
}
/**
* Reverse the migrations.
*
* @return void
*/
public function down()
{
Schema::dropIfExists('users');
}
}同时，确保您的 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;
// use \HighIdeas\UsersOnline\Traits\UsersOnlineTrait; // 如果您使用了此Trait，请保留
/**
* The attributes that are mass assignable.
*
* @var string[]
*/
protected $fillable = [
'name', // 确保 'name' 在可填充字段中
'password',
'skills',
'education',
'sponsor',
'telegram',
];
/**
* The attributes that should be hidden for serialization.
*
* @var array
*/
protected $hidden = [
'password',
'remember_token',
];
// ... 其他方法
}接下来，您需要修改登录表单视图 (resources/views/auth/login.blade.php) 和注册表单视图 (resources/views/auth/register.blade.php)，将用于输入登录凭据的 input 字段的 name 属性从 email 更改为 name。
login.blade.php 示例:
<!-- resources/views/auth/login.blade.php -->
@section('content')
<div class="container">
<div class="row justify-content-center">
<div class="col-md-8">
<div class="card">
<div class="card-header">{{ __('Login') }}</div>
<div class="card-body">
<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">
<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>
<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">
<input id="password" type="password" class="form-control @error('password') is-invalid @enderror" name="password" required autocomplete="current-password">
@error('password')
<span class="invalid-feedback" role="alert">
<strong>{{ $message }}</strong>
</span>
@enderror
</div>
</div>
<!-- ... 其他表单元素，如“记住我”和“忘记密码”链接 -->
<div class="form-group row mb-0">
<div class="col-md-8 offset-md-4">
<button type="submit" class="btn btn-primary">
{{ __('Login') }}
</button>
@if (Route::has('password.request'))
<a class="btn btn-link" href="{{ route('password.request') }}">
{{ __('Forgot Your Password?') }}
</a>
@endif
</div>
</div>
</form>
</div>
</div>
</div>
</div>
</div>
@endsectionregister.blade.php 示例:
<!-- resources/views/auth/register.blade.php -->
@section('content')
<div class="container">
<div class="row justify-content-center">
<div class="col-md-8">
<div class="card">
<div class="card-header">{{ __('Register') }}</div>
<div class="card-body">
<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">
<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>
<!-- ... 其他注册字段，如 telegram, skills, education, sponsor -->
<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">
<input id="password" type="password" class="form-control @error('password') is-invalid @enderror" name="password" required autocomplete="new-password">
@error('password')
<span class="invalid-feedback" role="alert">
<strong>{{ $message }}</strong>
</span>
@enderror
</div>
</div>
<div class="form-group row">
<label for="password-confirm" class="col-md-4 col-form-label text-md-right">{{ __('Confirm Password') }}</label>
<div class="col-md-6">
<input id="password-confirm" type="password" class="form-control" name="password_confirmation" required autocomplete="new-password">
</div>
</div>
<div class="form-group row mb-0">
<div class="col-md-6 offset-md-4">
<button type="submit" class="btn btn-primary">
{{ __('Register') }}
</button>
</div>
</div>
</form>
</div>
</div>
</div>
</div>
</div>
@endsection这是实现自定义登录字段的核心步骤。您需要在 App\Http\Controllers\Auth\LoginController 中重写 AuthenticatesUsers Trait 提供的 username() 方法。
// 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
{
/*
|--------------------------------------------------------------------------
| Login Controller
|--------------------------------------------------------------------------
|
| This controller handles authenticating users for the application and
| redirecting them to your home screen. The controller uses a trait
| to conveniently provide its functionality to your applications.
|
*/
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');
}
/**
* 获取用于控制器登录的用户名字段。
*
* @return string
*/
public function username()
{
return 'name'; // 将默认的 'email' 更改为 'name'
}
}通过添加上述 username() 方法并使其返回 'name'，您就指示了 Laravel 认证系统在尝试登录时，使用表单中提交的 name 字段值与数据库中的 name 字段进行匹配，而不是默认的 email 字段。
通过简单地在 LoginController 中重写 username() 方法，您可以轻松地将 Laravel 应用程序的默认登录凭据从 email 切换到任何您需要的字段，例如 name。这一改动使得 Laravel 的认证系统更加灵活，能够适应不同的业务需求。请务必在进行此类更改后，对登录和注册功能进行全面的测试，以确保一切正常工作。
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
448
收藏
