Customizando o serviço de autenticação do Laravel

.

Introdução

O Laravel possui um sistema de registro e autenticação pronto de fábrica muito completo e seguro que pode ser instalado com apenas alguns passos e recentemente um leitor me pediu para que eu o auxiliasse na alteração o login trocando o e-mail por um usuário. Pensando nisso, o artigo de hoje, será como alterar alguns pontos principais de autenticação e registro de usuários.

Adicionando mais campos ao formulário de registro

Antes de explicar como trocar o endereço de e-mail pelo nome do usuário vamos começar adicionando novos campos ao formulário, até mesmo porque essa etapa será necessária para realizar a troca. Para exemplificar, vamos adicionar o campo sobrenome e usuário que serão chamados de surname e username, respectivamente, para mantermos o padrão do Laravel que é o Inglês.

O primeiro passo é adicionar o campo à nossa tabela através de uma migration. Vamos criar uma nova migration com o comando abaixo:

php artisan make:migration --table users adicionar_campos_em_users_migration

Veja que foi criado um arquivo em database/migrations/{data}_adicionar_campos_em_users_migration.php com a classe AdicionarCamposEmUsersMigration. Altere o método up() para que ele adicione um novo campo à tabela:

public function up()
{
    Schema::table('users', function (Blueprint $table) {
        $table->string('surname');
        $table->string('username');
    });
}

Agora execute a migration para que ela altere de fato a tabela:

php artisan migrate

O segundo passo é declarar os novos campos como “preenchíveis” no modelo User encontrado em app/User.php (alteração em destaque):

$fillable = [
    'name',
    'email',
    'surname',
    'username’,
];

Feito isso, a última etapa é adicionar os campos no formulário de registro. Vamos editar o arquivo resources/views/auth/register.blade.php:

<div class="form-group row"> <label for="surname" class="col-md-4 col-form-label text-md-right"> {{ __('Surname') }} </label> <div class="col-md-6"> <input id="surname" type="text" class="form-control{{ $errors->has('surname') ? ' is-invalid' : '' }}" name="surname" value="{{ old('surname') }}" required > @if ($errors->has('surname')) <span class="invalid-feedback" role="alert"> <strong>{{ $errors->first('surname') }}</strong> </span> @endif </div> </div> <div class="form-group row"> <label for="username" class="col-md-4 col-form-label text-md-right"> {{ __('Username') }} </label> <div class="col-md-6"> <input id="username" type="text" class="form-control{{ $errors->has('username') ? ' is-invalid' : '' }}" name="username" value="{{ old('username') }}" required autofocus > @if ($errors->has('username')) <span class="invalid-feedback" role="alert"> <strong>{{ $errors->first('username') }}</strong> </span> @endif </div> </div>

Para finalizar basta alterar o método create() da classe RegisterController (app/Http/Controllers/Auth/RegisterController.php) e adicionar os novos campos:

protected function create(array $data)
{
    return User::create([
        'name' => $data['name'],
        'email' => $data['email'],
        'password' => Hash::make($data['password']),
        'surname' => $data['surname'],
        'username' => $data['username'],
    ]);
}

Logando com usuário ao invés de e-mail

Por padrão o Laravel utiliza o endereço de e-mail por ele ser uma informação já conhecida pelo usuário e pelo fato de ser único, mas se você quiser alterar essa informação basta seguir o exemplo acima e adicionar o campo na tabela, no modelo e na view e depois sobrescrever o método username() na classe LoginController (app/Http/Controllers/Auth/LoginController.php), pois se você analisar o código, verá que a classe LoginController importa a classe AuthenticatesUsers:

class LoginController extends Controller { use AuthenticatesUsers; ...

Ao verificar a classe AuthenticatesUsers nós podemos encontrar um método chamado username() que retorna o campo que será utilizado para autenticação:

public function username() { return 'email'; }

Como não podemos alterar o método direto na classe, basta redeclará-la na classe LoginController e alterar o retorno para o nome do campo, no caso, username:

public function username() { return 'username'; }

Alterar a validação dos campos

Por padrão todos os quatro campos do formulário de registro são obrigatórios, mas se você quiser alterar ou adicionar qualquer validação ou até mesmo adicionar alguma validação para os campos que você adicionou no formulário de registro basta alterar o método validator() da classe RegisterController (app/Http/Controllers/Auth/RegisterController.php):

protected function validator(array $data)
{
    return Validator::make($data, [
        'name' => ['required', 'string', 'max:255'],
        'email' => ['required', 'string', 'email', 'max:255', 'unique:users'],
        'password' => ['required', 'string', 'min:6', 'max:255', 'confirmed'],
        'type' => ['required', 'string'],
        'username' => ['required', 'string', 'max:255', 'min:6', 'unique:users'],
    ]);
}

No código acima eu defini que o campo password pode ter no máximo 255 caracteres, e que o campo username deve ser obrigatório, do tipo texto, com no máximo 255 caracteres, no mínimo 6 caracteres e único, ou seja, ninguém mais pode ter o mesmo valor coluna username na tabela users.

Habilitar a verificação de e-mail

Esta é uma função que vem desabilitada por padrão no Laravel 5.7 mas todas as rotas e campos já estão implementados, somente inativos. Para habilitar a verificação basta alterar a rota passando a verificação como true no arquivo routes/web.php:

Auth::routes(['verify' => true]);

Agora para proteger uma rota e garantir que ela seja acessada somente por pessoas verificadas utilize o middleware verified, como nos exemplos abaixo:

Route::get('profile', function () { // ... })->middleware('verified'); Route::resource('/imagens', 'ImagemController') ->middleware('verified');

Desabilitar a redefinição de senha

Aproveitando o gancho do item anterior, é possível desabilitar a função de redefinir a senha praticamente da mesma forma que passo anterior, basta alterar a rota com o parâmetro reset como falso:

Auth::routes(['reset' => false]);

Se você estiver como se perguntando como fazer para que o seu sistema tenha uma verificação de e-mail e não permita a redefinição de senha, fique tranquilo! É possível passar todos os parâmetros,visto que estamos passando na verdade um array:

Auth::routes([ 'reset' => false, 'verify' => true, ]);

Desabilitar novos registros

Como você deve adivinhar para desabilitar os novos registros é muito simples e feito da mesma forma que as dicas anteriores, basta adicionar o parâmetro register e defini-lo como falso.

Auth::routes(['register' => false]);

Conclusão

No artigo de hoje vimos como é simples alterar as configurações do sistema de registro e autenticação do Laravel. Você deve ter percebido que grande parte das funcionalidades podem ser ativadas, desativas ou alteradas nos controllers ou diretamente na declaração da rota.

Espero muito que tenha gostado e até a próxima!