Laravel 8 登录字段定制：将默认邮箱登录切换为用户名登录-php教程-PHP中文网

Laravel 8 登录字段定制：将默认邮箱登录切换为用户名登录

霞舞

发布： 2025-10-31 12:03:15

原创

174人浏览过

Laravel 8 登录字段定制：将默认邮箱登录切换为用户名登录

本教程详细指导如何在 laravel 8 中将默认的用户登录凭证从邮箱（email）更改为用户名（name）。通过覆盖 `logincontroller` 中的 `username()` 方法，并确保前端表单和数据库结构匹配，开发者可以轻松实现基于用户名的自定义登录功能，解决仅修改视图文件导致登录失败的问题。

Laravel 提供了强大而灵活的认证系统，默认情况下，它使用用户的邮箱地址作为登录凭证。然而，在许多实际应用中，开发者可能需要将登录凭证更改为用户名（或任何其他唯一字段）。本文将详细介绍如何在 Laravel 8 项目中，将默认的邮箱登录机制定制为使用用户名进行认证。

理解 Laravel 默认登录机制

Laravel 的认证功能主要通过 AuthenticatesUsers trait 提供，该 trait 被 LoginController 所使用。这个 trait 内部通过一个名为 username() 的方法来确定用于认证的字段名。默认情况下，AuthenticatesUsers trait 中的 username() 方法返回 'email'，这意味着 Laravel 会尝试使用 email 字段来匹配用户。

因此，即使您在 login.blade.php 视图文件中将登录输入框的 name 属性从 email 更改为 name，后端认证逻辑仍然会尝试查找 email 字段，导致登录尝试失败，或出现页面加载但无任何变化的情况。

实现自定义用户名登录

要将 Laravel 的默认登录凭证从邮箱切换到用户名，核心在于覆盖 LoginController 中默认的 username() 方法。

1. 修改 LoginController

打开 app/Http/Controllers/Auth/LoginController.php 文件。在该控制器中，您需要添加或修改 username() 方法，使其返回您希望用于登录的字段名，即 'name'。

吐司AI

超多功能的免费在线生图网站！拥有全网更齐全的模型库，0门槛使用！

325

查看详情

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;

    /**
     * 登录后用户重定向的路径。
     *
     * @var string
     */
    protected $redirectTo = RouteServiceProvider::HOME;

    /**
     * 创建一个新的控制器实例。
     *
     * @return void
     */
    public function __construct()
    {
        $this->middleware('guest')->except('logout');
    }

    /**
     * 获取控制器将使用的登录用户名。
     *
     * @return string
     */
    public function username()
    {
        return 'name'; // 将默认的 'email' 替换为 'name'
    }
}

登录后复制

通过添加上述 username() 方法，您告诉 Laravel 的认证系统，在进行用户认证时，应该使用请求中的 name 字段来匹配数据库中的 name 字段。

2. 确保前端表单与数据库字段一致

除了修改控制器，还需要确保前端登录表单和后端数据库结构都与您的自定义设置保持一致。

登录视图 (login.blade.php): 确保您的登录表单中，用于输入用户名的 input 元素的 name 属性设置为 name。这确保了用户输入的值能够以正确的键名发送到服务器。

<!-- resources/views/auth/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>
<!-- ... 其他表单内容 ... -->

登录后复制

用户模型 (app/Models/User.php): 确认 User 模型中的 $fillable 数组包含 name 字段，以便在注册时可以进行批量赋值。

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

    /**
     * 可批量赋值的属性。
     *
     * @var string[]
     */
    protected $fillable = [
        'name', // 确保 'name' 字段在这里
        'password',
        'skills',
        'education',
        'sponsor',
        'telegram',
    ];

    // ... 其他模型定义 ...
}

登录后复制

数据库迁移 (database/migrations/xxxx_xx_xx_xxxxxx_create_users_table.php): 验证 users 表的迁移文件中包含 name 字段，并且通常应该设置为 unique 以确保用户名的唯一性。

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateUsersTable extends Migration
{
    /**
     * 运行数据库迁移。
     *
     * @return void
     */
    public function up()
    {
        Schema::create('users', function (Blueprint $table) {
            $table->id();
            $table->string('name')->nullable()->unique(); // 确保 name 字段存在且为 unique
            $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();
        });
    }

    /**
     * 回滚数据库迁移。
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('users');
    }
}

登录后复制

注意事项

字段唯一性: 当使用用户名作为登录凭证时，务必确保数据库中的 name 字段是唯一的 (->unique())。这可以防止多个用户拥有相同的用户名，从而避免认证冲突和安全问题。
注册逻辑: 确保您的注册逻辑（通常在 RegisterController 中）正确地将用户输入的用户名存储到 name 字段中。从提供的 register.blade.php 来看，它已经正确地将用户名输入框的 name 属性设置为 name。
验证规则: 在注册和登录时，为 name 字段添加适当的验证规则（例如 required|string|max:255|unique:users），以确保数据的完整性和安全性。
用户体验: 考虑是否允许用户在注册后更改其用户名，以及更改后可能对用户登录体验产生的影响。

总结

通过在 LoginController 中简单地覆盖 username() 方法，并确保前端表单和数据库结构的一致性，您可以轻松地将 Laravel 的默认认证机制从邮箱切换到用户名。这种方法灵活且侵入性小，是 Laravel 框架设计优雅性的体现，允许开发者根据项目需求定制认证行为。完成这些步骤后，您的 Laravel 应用程序将能够使用用户名而非邮箱进行用户登录。

以上就是Laravel 8 登录字段定制：将默认邮箱登录切换为用户名登录的详细内容，更多请关注php中文网其它相关文章！