Grupos de Ruta

A menudo, un grupo de rutas comparte una característica particular — un determinado requisito de autenticación, un prefijo de ruta o quizás un espacio de nombres de controlador. Definir estas características compartidas una y otra vez en cada ruta no solo parece tedioso, sino que también puede enturbiar la forma de su archivo de rutas y oscurecer algunas de las estructuras de su aplicación.

Los grupos de rutas le permiten reducir esta duplicación al agrupar varias rutas y aplicar cualquier configuración compartida una sola vez a todo el grupo. Además, los grupos de rutas son señales visuales para los futuros desarrolladores (y para su propio cerebro) de que estas rutas están agrupadas.

Para agrupar dos o más rutas, “rodee” las definiciones de ruta con un grupo de rutas, como se muestra en el siguiente ejemplo. En realidad, se pasa una clausura a la definición del grupo y se definen las rutas agrupadas dentro de esa clausura.

Definición de un grupo de rutas

Route::group(function () {
    Route::get('hello', function () {
        return 'Hello';
    });
    Route::get('world', function () {
        return 'World';
    });
});

De forma predeterminada, un grupo de rutas no hace nada. No hay diferencia entre usar el grupo en el ejemplo anterior y separar un segmento de las rutas con comentarios de código.

Middleware

Probablemente el uso más común de los grupos de rutas es aplicar middleware a un grupo de rutas. Aprenderá más sobre middleware aquí, pero, entre otras cosas, es lo que Laravel usa para autenticar usuarios y restringir que los usuarios invitados utilicen ciertas partes de un sitio.

En el ejemplo siguiente, estamos creando un grupo de rutas en torno a las vistas del panel y de la cuenta, y aplicando el middleware de autenticación a ambas. En este ejemplo, esto significa que los usuarios deben iniciar sesión en la aplicación para ver el panel o la página de la cuenta.

Restringir un grupo de rutas solo a usuarios que hayan iniciado sesión

Route::middleware('auth')->group(function() {
    Route::get('dashboard', function () {
        return view('dashboard');
    });
    Route::get('account', function () {
        return view('account');
    });
});

A menudo, resulta más claro y directo adjuntar middleware a las rutas en el controlador en lugar de hacerlo en la definición de la ruta. Puede hacerlo llamando al método middleware() en el constructor de su controlador. La cadena que pasa al método middleware() es el nombre del middleware y, opcionalmente, puede encadenar métodos modificadores (only() y except()) para definir qué métodos recibirán ese middleware:

class DashboardController extends Controller
{
    public function __construct()
    {
        $this->middleware('auth');

        $this->middleware('admin-auth')
            ->only('editUsers');

        $this->middleware('team-member')
            ->except('editUsers');
    }
}

Tenga en cuenta que si realiza muchas personalizaciones only() y except(), eso suele ser una señal de que debe utilizar un nuevo controlador para las rutas excepcionales.

Una Breve Introducción a Eloquent

Cubriremos Eloquent, el acceso a bases de datos y el generador de consultas de Laravel en profundidad aquí, pero habrá algunas referencias hasta ahora que harán que una comprensión básica sea útil.

Eloquent es el mapeador relacional de objetos de base de datos ActiveRecord (ORM) de Laravel, que facilita la relación de una clase Post (modelo) con la tabla de base de datos posts y la obtención de todos los registros con una llamada como Post::all().

El generador de consultas es la herramienta que permite realizar llamadas como Post::where('active', true)->get() o incluso DB::table('users')->all(). Estás construyendo una consulta encadenando métodos uno tras otro.

Prefijos de Ruta

Si tiene un grupo de rutas que comparten un segmento de su ruta — por ejemplo, si el panel de control de su sitio tiene el prefijo /dashboard — puede usar grupos de rutas para simplificar esta estructura (consulte el el siguiente ejemplo).

Prefijando un grupo de rutas

Route::prefix('dashboard')->group(function () {
    Route::get('/', function () {
        // Handles the path /dashboard
    });
    Route::get('users', function () {
        // Handles the path /dashboard/users
    });
});

Tenga en cuenta que cada grupo con prefijo también tiene una ruta / que representa la raíz del prefijo (en el Ejemplo anterior es /dashboard).

Enrutamiento de Subdominios

El enrutamiento de subdominios es lo mismo que la prefijación de rutas, pero su alcance es el subdominio en lugar del prefijo de ruta. Esto tiene dos usos principales. En primer lugar, es posible que desee presentar diferentes secciones de la aplicación (o aplicaciones completamente diferentes) a diferentes subdominios. El siguiente ejemplo muestra cómo puede lograrlo.

Enrutamiento de subdominio

Route::domain('api.myapp.com')->group(function () {
    Route::get('/', function () {
        //
    });
})

En segundo lugar, es posible que desees establecer parte del subdominio como parámetro, como se ilustra en el ejemplo siguiente. Esto se hace con mayor frecuencia en casos de multiusuario (piensa en_ Slack_ o Harvest, donde cada empresa obtiene su propio subdominio, como tight.slack.co).

Enrutamiento de subdominio parametrizado

Route::domain('{account}.myapp.com')->group(function () {
    Route::get('/', function ($account) {
        //
    });
    Route::get('users/{id}', function ($account, $id) {
        //
    });
});

Tenga en cuenta que todos los parámetros del grupo se pasan a los métodos de las rutas agrupadas como el primer parámetro(s).

Prefijos de Nombres

Es común que los nombres de las rutas reflejen la cadena de herencia de los elementos de la ruta, por lo que users/comments/5 será atendido por una ruta llamada users.comments.show. En este caso, es común utilizar un grupo de rutas alrededor de todas las rutas que se encuentran debajo del recurso users.comments.

Al igual que podemos anteponer segmentos de URL, también podemos anteponer cadenas al nombre de la ruta. Con los prefijos de nombre de grupo de rutas, podemos definir que cada ruta dentro de este grupo debe tener una cadena dada antepuesta a su nombre. En este contexto, anteponemos users. a cada nombre de ruta y luego comments. (ver ejemplo siguiente).

Prefijos de nombres de grupos de rutas

Route::name('users.')->prefix('users')->group(function () {
    Route::name('comments.')->prefix('comments')->group(function () {
    Route::get('{id}', function () {
        // ...
    })->name('show'); // Route named 'users.comments.show'

    Route::destroy('{id}', function () {})->name('destroy');
    });
});

Controladores de Grupos de Rutas

Cuando se agrupan rutas que son atendidas por el mismo controlador, como cuando mostramos, editamos y eliminamos usuarios, por ejemplo, podemos usar el método controller() del grupo de rutas, como se muestra en el ejemplo siguiente, para evitar tener que definir la tupla completa para cada ruta.

Controladores de grupos de rutas

use App\Http\Controllers\UserController;

Route::controller(UserController::class)->group(function () {
    Route::get('/', 'index');
    Route::get('{id}', 'show');
});

Ruta de Respaldo

En Laravel puedes definir una “fallback route” (que debes definir al final de tu archivo de rutas) para capturar todas las solicitudes no coincidentes:

Route::fallback(function () {
    //
});