Usuario:ManuelRomero/Laravel/routing

De WikiEducator
Saltar a: navegación, buscar
Road Works.svg Trabajo en proceso, espera cambios frecuentes. Tu ayuda y retroalimentación son bienvenidos.
Ver página de charlas.
Road Works.svg




__NOSECCTION__

Qué es routing



Icon key points.gif

URL Vs Ruta (route)

  • Una aplicación web es invocada mediante una solicitud http, usando sus verbos get o postprincipalmente.
  • Para ello solicitamos un recurso mediante lo que comunmente llamamos URL


  • En las aplicaciones que venimos desarrollando en el curso, el proceso de ejecución de la solicitud de un recurso web de forma básica es:
  • 1.-El cliente escribe una url solicitando una página web o php p.e.
http://localhost/paginaPrincipal.php
  • 2.-Ahora el servidor web procesa la petición ejecutando el fichero php y retornando una página web al cliente.
Icon present.gif
Tip: Entendemos que existe un fichero en el servidor con el nombre paginaPrincipal.php


  • Es esta la primera diferencia que podemos encontrar con una aplicación web tradicional de PHP como hemos venido trabajando a lo largo del curso
  • Ahora no vamos a funcionar exactamente así en la parte del servidor
  • Meditante el routing, vamos a especificar los diferentes recursos que nuestrta aplicación va a atender como solicitudes http
  • Esto se hará en un único fichero donde se especifican estas rutas web.php de modo que todo lo relacionado con las rutas esté ahí especificado
/routes/web.php



Icon define.gif
Una ruta en laravel
Una ruta Laravel es la definición de una URL de solicitud web.
que accede a una página o recurso web particular de la aplicación, 
y la acción correspondiente a esta solicitud


  • En la carpeta routes, tenemos 4 ficheros de rutas:
routes/api.php:Para definair las rutas de las APIs de nuestra aplicación.
routes/channels.php:Los canales transmisión de eventos.(notificaciones en tiempo real).
routes/console.php: Para poder crearnos nuestros propios comandos de consola que usaremos con artisan.
routes/web.php:
En este archivo de rutas es donde definimos todas las rutas de nuestra aplicación web
Son estas las rutas que pueden ser ingresadas por la barra de direcciones del navegador.

Contenido de web.php


  • El proceso quedará definido por la siguiente secuencia
  • El cliente escribirá una ruta a la que quiere acceder en forma de URL y la aplicación buscará dicha ruta en el fichero web.php.
  • Una aproximación (en realidad hay muchos ficheros que se ejecutan entre medias. ver ciclo de vida de una aplicación laravel), podemos ver en la siguiente imagen

Rutas laravel 1.png

  • Hay diferentes maneras de especificar estas rutas en el fichero web.php, como vamos a ver a continuación

Levantando el servidor

  • Antes de probar las rutas, debemos de poner nuestro servidor en funcionamiento. Para ello cada proyecto tiene un pequeño servidor interno que nos permite probar en local su funcionamiento sin necesidad de depender de apache.
  • Primero levantamos el servidor que viene con laravel en el puerto 8000
  • Para ello usamos los comandos de artisan
php artisan serve
  • Si estamos con docker, deberemos de indicar que el navegador o la solicitud se pueda hacere desde cualquier host con la opción --host 0.0.0.0
php artisan serve --host 0.0.0.0
Icon present.gif
Tip: Artisan viene de artesano y es un poderoso interfaz de comandos que nos va a permitir realizar muchas acciones de forma rápida en nuestro proyecto


  • Y vemos la siguiente salida, que responde al route con la URL /
Laravel development server started on http://localhost:8000
LaravelLocalhost.png

Especificando la ruta en Laravel


  • Para ello se usa la clase Router
https://laravel.com/docs/master/routing
  • Para agilizar su uso usamos lo que en laravel se conoce como Facade


Icon define.gif
Facade
  • Una facade es una interfaz estática de una clase de sevice container
  • Cuando usamos una facade se produce lo que se llama inyección de dependencias
    • Esto implica que se importarán todas las clases necesarias para su ejecución de manera implícita


  • De esta forma no tendremos que instaciar un objeto de la clase Router
https://laravel.com/api/master/Illuminate/Routing/Router.html
  • Esta clase tiene una serie de métodos para especificar las rutas que corresponden al tipo de solicitud http que se hace al servidor
  • Estos métodos son palabras (verbos) que representan el tipo de solicitud http que se hace al servidor.(Ver protocolo http para este cometido).
  • Se suele usar get(), para solicitudes de páginas que no envían datos y post() si se envían datos
  • Aquí una lista de posibles verbos a utilizar
<? php
// app/web.php
Route::get($uri, $callback);
Route::post($uri, $callback);
Route::put($uri, $callback);
Route::patch($uri, $callback);
Route::delete($uri, $callback);
Route::options($uri, $callback);
?>
  • También podemos tener verbos o métodos flexibles que veremos posteriormente
//Cualquiera de los métodos get o post
Route::match(['get', 'post'], '/', function () {
    //
});
//Cualquier método o verbo http 
Route::any('foo', function () {
    //
});
  • El método especificado, recibe dos parámetros:
  1. El URL o URI que el cliente solicitará
  2. La acción que se va a realizar para retornar un contenido al cliente según la url solicitada.
  • En función de como se especifique esta acción tenemos diferentes formas de hacer Routing, objeto de estudio de los siguientes apartados

Routin básico : funciones anónimas o Clousuras


  • En este caso la acción básica va a ser una función anónima o de clausura.
  • Una función de clausura es una función sin nombre (anónima) que se ejecutará y puede retornar algún valor.
  • En la función podemos hacer un echo, retornar un texto, retornar una vista, o lo que queramos o necesitemos. Ahora haremos los ejemplos comentados.
  • Vamos a dotar a nuestra aplicación del recurso o ruta llamada 'primera
route::get("primera", function(){
       return ("<h1>Estás en la página primera con método GET</h1>");
});
  • Podemos ver como con echo, funciona igual (cambiamos el url de la ruta).
route::get("primera_echo", function(){
       echo  ("<h1>Estás en la página primera con método GET</h1>");
});
  • También podemos hacer que nos devuelva una vista o página html
  • Para ello creamos una vista


Icon key points.gif

Vista en laravel

  • Utiliza un gestor de plantillas llamadas blade
  • Ficheros con extensión blade.php
  • Ubicadas en /resources/view
  • No olvidar que es html



  • En este primer caso vamos a probar el ejemplo.
  • Creamos la vista con un código html básico
prueba.blade.php
<!doctype html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport"
          content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Document</title>
</head>
<body>
<h1>Esto es una prueba</h1>
</body>
</html>
  • Ahora agregamos la ruta.

Para cargar la vista podemos usar el helper view o bien el método estático make de la Facade View

Route::any('about',function(){
    return View::make('prueba');
});
Route::any('about',function(){
    return view('prueba');
});
Routes view
*Se puede establecer directamente con el método view de la facade Route la ruta y el nombre de la vista
<source lang=php>
Route::view('ruta','vista');


Icon activity.jpg
practica con rutas básicas
  • Haz un sitio con 5 url básicas
  • Crealas bajo un directorio llamado rutas_basicas en resources/view

las lamaremos

about principal contacta noticas
  • Cada una de ellas mostrará simplemente un texto que comente la página donde estoy
<h1>Estoy en la página principal</h1>
  • Después prueba a crear un menú con submit que me permita navegar en una nueva página llamada navegación
  • Ahora intenta poner un botón volver en cada una que me lleve de nuevo a navegar






Icon summary.gif

Resumen

  • Las rutas se especifican en el fichero ./routes/web.php




Icon summary.gif

Resumen

  • Se especifica la clase route con los métodos get() o post() o any() principalmente




Icon summary.gif

Resumen

  • En su uso básico especificamos dos argumentos al método: una URI y una Closure o función anónima


  • Lógicamente las rutas con método post no los visualizaremos directamente desde el navegador. es decir si escribimos
http://localhost:8000/principalPost
  • No me aparecerá, y si vemos los errores, veremos que aparece un acceso no permitido
  • Podemos comprobarlo con curl en línea de comandos
 curl -d "" http://localhost:8000/principalPost


  • Ver el siguintes tutorial:



Artisan: Visualizando rutas

  • Podemos visualizar las rutas con el comando de artisan
php artisan  route:list
  • Esto ha sido una mejora importante en laravel 9 (antes la visualización era menos explícita)
  • Hay rutas que son definidas por paquetes instalados en laravel, como por ejemplo la visualización de errores cuando se producen. Si queremos que éstas no se visualicen, debemos especificarlo
php artisan  route:list --except-vendor


Pasando parámetros a las rutas


  • Parte de la ruta puede ser parametrizada, es decir podemos especificar variables una ruta, de forma que parte del nombre de la ruta sea un valor para la url
Route::get('/numero/{number}', function($number){
    Return "<h2>Estás en el número $number</h2>";
});
*Laravel  '''''inyecta''''' el valor de cada parámetro, en la función de callback que va a ejecutar
*Los nombres de los parámetros deben de ir entre brackets '''''{}'''''
*Los nombres de las variables en la función o en el controlador, no han de coincidir, y laravel los asigna de forma respectiva
 
<source lang=php>
Route::get('Nombre/{nombre}/libro/{libro}', function($miNombre, $otroLibro){
    return "<h1>invocando con -$miNombre- y libro $otroLibro</h1>";
});


Escribiendo este codigo podemos acceder a las siguientes URL's*

#http://localhost:8000/noticias/1
#http://localhost:8000/noticias/1000
#http://localhost:8000/noticias/pepito
  • Y nos saldría la información correspondiente



Icon activity.jpg
Routing parametrizado
  • Prueba el ejemplo anterior y en cada caso que nos muestre noticia
  • Intenta hacer una ruta que podamos especificar sección y apartado, es decir
Noticias y noticia número 6
Deportes y deporte número 2
  • En este caso debemos tener dos parámetros
  • Intenta que la función anónima nos devuelva una vista (periodico) en lugar del texto
  • Cuelga la vista en /resources/views/pruebas/parametrizadas




Parametros por defecto y chequeando valores

  • Podríamos querer limitar el parámetro a un tipo de valores concreto (por ejemplo en este caso a número)
  • Lo podemos hacer usando expresiones regulares con el método pattern'
Route::pattern('num', '[0-9]+');
 
Route::get("noticias/{num}", function($num){
       return ("Estás en la noticia número  -".$num);
});
  • Usar este método, fuerza a esta variable o parámetro en cualquier aparción
  • Si pretendemos este objetivo, la ubicación correcta de este método boot de la clase App\Providers\RouteServiceProvider class:
  • En este caso solo funcionará en la última parte de la url sea un número
  • Parámetros con valores por defecto por si no se aportan
Route::get('noticias/{nombre?}', function($name = 'deportes')
{
    return ("Estás en las noticias de tipo ".$name);
});

(Comment.gif: No te olvides de asignar un valor por defecto a la variable que inyectará el valor del parámetro)


Restricciones


  • Parámetros con restricciones de valor (si es número ...., si es caracteres ... ...)
  • En este caso solo se aplica al parámetro de la ruta.
Route::get('noticias/tipo/{nombre}', function($nombre)
{
   return("Ahora estás viendo las noticias ".$nombre);
})
->where('name', '[A-Za-z]+');
 
Route::get('noticias/{num}', function($num)
{
       retunr("Ahora estás en la noticia número ".$num);
})
->where('id', '[0-9]+');
  • Existens unos helper para facilitar este tipo de acciones
Route::get('noticias/tipo/{nombre}', function($nombre)
{
   return("Ahora estás viendo las noticias ".$nombre);
})
->->whereAlphaNumeric('name');
 
Route::get('noticias/{num}', function($num)
{
       retunr("Ahora estás en la noticia número ".$num);
})
->whereNumeric('id');
Route::get('/libro/{categoria}', function ($categoriaLibro) {
    //
})->whereIn(['policiaca', 'técnica', 'medicina']);


Nombrando rutas


A una ruta le podemos poner un nombre. De esta forma la podemos invocar desde cualquier sitio sin tener que escribir la ruta completa, así como generar la url de una ruta.

  • Crear un nombre de una ruta

Acción por defecto en el enrutado

  • Si la ruta no aparece, podemos determinar una acción por defecto
Route::fallback(function () {
    return "<h2>LA ruta no está recogida </h2>"
});