Cómo hacer login con username o email en Laravel 5.1

Hace poco he retomado Laravel y he decidido actualizar un proyecto que tenía de la versión 5.0 a la 5.1 (no he querido lanzarme a la 5.2 todavía). La cosa es que en este proyecto tenía preparado el acceso de usuarios (login) para que pudieran acceder con su nombre de usuario o su email indistintamente más la contraseña pero en Laravel 5.1 de nuevo el Auth no viene preparado para esto.

En la versión 5.0 ya lo solucioné e hice un pequeño tutorial al respecto: Laravel 5 cómo hacer login con email o username

Pero para Laravel 5.1 quería hacer algo un poco más sencillo y elegante, así que me puse a buscar y preguntar.

Encontré que es fácil cambiar de login con email, que es la opción por defecto, a login con username. No hay más que añadir una variable protected al AuthController.

class AuthController extends Controller {
...
protected $username = "username";

 

Encontré, y me comentaron también, cómo hacerlo añadiendo un código sencillo en un archivo dentro de vendor pero aunque se supone que añadiendo alguna línea también en el composer.json esa solución no iba a sobreescribirse en el próximo composer update no me convencía la solución.

Finalmente llegué a mi propia solución sencilla, segura y sin necesidad de tocar el vendor, voy a explicarla en 6 pasos:

 1. Declaramos el campo login para la credencial del usuario

En el formulario que utilicemos para que el usuario haga login, ponemos un input name=»login» en lugar de input name=»email» o input name=»username»

 

2. Asignamos un Route que ejecutará el login

En la ruta donde va el formulario para identificar al usuario vamos a cambiar ‘AuthController@postLogin‘ por ‘CustomAuthController@postLogin’ o el nombre que queramos darle al nuevo controller.

Route::post( 'auth/login', 'CustomAuthController@postLogin');

 

3. Creamos nuestro CustomAuthController

Creamos un nuevo controller al que llamamos CustomAuthController.php u otro nombre, esto queda al gusto del consumidor.

 

4. Echamos una miradita a AuthController

Ahora vamos a echar una miradita a AuthController y vamos a encontrar que tiene la línea

use AuthenticatesAndRegistersUsers, ThrottlesLogins;

Esto quiere decir que está usando esos dos traits. ThrottlesLogins controla la cantidad de intentos de acceso, AuthenticatesAndRegistersUsers es el que nos interesa ahora. Mirando un poco más arriba en el archivo encontramos su ruta y vamos a hacerle una visita.

use Illuminate\Foundation\Auth\AuthenticatesAndRegistersUsers

Entramos en vendor \ laravel \ framework \ src \ Illuminate \ Foundation \ Auth \ AuthenticatesAndRegistersUsers y encontramos que no hay casi nada porque este archivo a su vez hace uso de AuthenticatesUsers que es quien realmente tiene lo que buscamos.

use AuthenticatesUsers, RegistersUsers { ...

En AuthenticatesUsers está la función que queremos: postLogin. La copiamos entera y la pegamos en nuestro CustomAuthController.

 

5. Rellenando nuestro controlador: CustomAuthController

Ahora vamos a añadir algunas líneas en nuestro CustomAuthController para ponerlo en marcha

namespace App\Http\Controllers\Auth;

use Illuminate\Support\Str;
use Illuminate\Support\Facades\Auth;
use Illuminate\Http\Request;
use Illuminate\Foundation\Auth\AuthenticatesUsers;

use App\Http\Requests;
use App\Http\Controllers\Controller;

class CustomAuthController extends Controller
{
use AuthenticatesUsers;

protected $redirectPath = '/descubre';
protected $username = 'login';

public function postLogin(Request $request)
{ ...

Esto es lo necesario hasta llegar al único método de nuestro Controller que es el que nos importa, el postLogin.

De un repaso rápido vemos que estamos utilizando (use) AuthenticatesUsers para sobreescribir su método postLogin,

protected $redirectPath está aquí para definir la ruta donde mandamos al usuario una vez identificado y protected $username es el nombre del campo login que hemos añadido/cambiado antes en el formulario de acceso de usuario.

 

 6. El meollo de la cuestión, el método postLogin

Tenemos el método postLogin traido de AuthenticatesUsers tal cual y vamos a hacer un pequeño cambio para adaptarlo a lo que queremos.

Buscamos las líneas encargadas de recoger las credenciales ($credentials) del usuario, su nombre ( email o username ) y contraseña y de probar a acceder con ellas.

$credentials = $this->getCredentials($request);

if (Auth::attempt($credentials, $request->has('remember'))) {
return $this->handleUserWasAuthenticated($request, $throttles);
}

y metemos en medio este foreach cuya función es recorrer las credentials y evaluar si el valor del campo login es un email o no para decirle después a Laravel si lo que viene como nombre tiene que comprobarlo con el campo email o con el campo username.

foreach ($credentials as $key => $value) {

if (! Str::contains($key, 'password')) {
$newkey = filter_var( $value, FILTER_VALIDATE_EMAIL) ? 'email' : 'username';
$credentials[$newkey] = $value;
unset($credentials[$key]);
}
}

Y finalmente nos queda el método postLogin completo tal que así:

public function postLogin(Request $request)
{

$this->validate($request, [
$this->loginUsername() => 'required', 'password' => 'required',
]);

// If the class is using the ThrottlesLogins trait, we can automatically throttle
// the login attempts for this application. We'll key this by the username and
// the IP address of the client making these requests into this application.
$throttles = $this->isUsingThrottlesLoginsTrait();

if ($throttles && $this->hasTooManyLoginAttempts($request)) {
return $this->sendLockoutResponse($request);
}

$credentials = $this->getCredentials($request);

foreach ($credentials as $key => $value) {

if (! Str::contains($key, 'password')) {
$newkey = filter_var( $value, FILTER_VALIDATE_EMAIL) ? 'email' : 'username';
$credentials[$newkey] = $value;
unset($credentials[$key]);
}
}

if (Auth::attempt($credentials, $request->has('remember'))) {
return $this->handleUserWasAuthenticated($request, $throttles);
}

// If the login attempt was unsuccessful we will increment the number of attempts
// to login and redirect the user back to the login form. Of course, when this
// user surpasses their maximum number of attempts they will get locked out.
if ($throttles) {
$this->incrementLoginAttempts($request);
}

return redirect($this->loginPath())
->withInput($request->only($this->loginUsername(), 'remember'))
->withErrors([
$this->loginUsername() => $this->getFailedLoginMessage(),
]);
}

 

 Y listo, ya hemos preparado nuestro login con username o email en laravel 5.1 con estos sencillos 6 pasos.

Me gustaría terminar lanzando una pregunta a quien lea esto: ¿consideras que aún es necesario o útil el login con username o ya solo debería hacerse con email porque lo del username es muy 90’s?

Este fue un pequeño debate que surgió cuando pregunté a unos amigos ( también desarrolladores ) sobre cómo hacer esto y me gustaría conocer más opiniones.

(Imágenes de pixabay.com)