advanced-routing.md

🏁 Advanced Routing

In order to initialize router package, visit:

{% content-ref url="./" %} . {% endcontent-ref %}

Route Parameters

In fastvolt, you can define route parameters by enclosing them in curly braces {id} or by using colon :id, these parameters capture values from the URL and pass them to your route handler as variables.

URL Snippet

let's consider this url for an example:

http:://www.myblog.net/blog/13

Logic Representation:

Route::get('/blog/{id}', function(int $id) {
    return "you are viewing blog id: {$id}";
});

The above code snippet captures the {id} value from the url snippet, then converts the {id} to variable. The output of the above code while accessing the url: http:://www.myblog.net/blog/13 from the browser will be:

you are viewing blog id: 13

Route Groups

Route groups allow you to apply common attributes, such as middleware or add sub-routes to a parent main route.

Route grouping is useful when you want to group a bunch of sub-routes under a particular parent route.

The route group method takes only four parameters:

Route::group($prefix, $middleware, $namespace);

• prefix: string.
• middleware: array|string.
• namespace: string.

Code Representation

$route = Route::group('user');

  # uri: '/user/dashboard'
  $route->get('/dashboard', function() {
         return out('This is the main user dashboard!');
  });
    
  # uri: '/user/profile'
  $route->get('/profile', function() {
         return out('This is the user profile!');
    });

Middleware

Middleware is a very simple and straight-forward way to filter HTTP requests entering your application. You can apply middleware to routes or route groups to perform tasks like authentication, authorization, and input validation.

Middleware can be assigned to single route in this format:

Route::get('/user', function() {

   // ...
 
}, ['middleware1']);

Or:

Route::middleware(['middleware1'])->get('/', function() {
   // ..
});

Or you can apply middleware to route groups in this format:

$route = Route::group('user', ['middleware1', 'middleware2']);
   # index page 
   $route->get('/', function() {
      // ...
   });
   
   # blog page
   $route->get('/blog', function() {
      // ...
   });

The 'middleware1', 'middleware2' will automatically be applied to all sub-routes in the example above.

Namespace Routes

Namespace route is useful only when you have your controller files in another directory except from the main controller directory App\Http\Controller, then you can specify the exact directory namespace in this format:

For example, if we created a new folder app/Http/Controller/Auth which has a namespace of App\Http\Controller\Auth , and also created a new UserController.php file which contains the following code:

<?php

namespace App\Http\Controller\Auth;

use FastVolt\Core\Controller;

class UserController extends Controller {

  public function index(){
    // ...
  }
  
  public function login(){
    // ...
  }
  
  public function register(){
    // ...
  }

}

We can implement request routing to access this controller and it's methods using the below code format:

$auth = Route::namespace('App\Http\Controller\Auth');

   // returns 'index' method
   $auth->get('/' 'UserController@index');
   
   // returns 'login' method
   $auth->get('/login' 'UserController@login');
   
   // returns 'register' method
   $auth->get('/register' 'UserController@register');