59. Construcción de Rutas

  Construyendo Rutas en una API REST con PHP Nativo

En esta clase, aprenderemos a crear las rutas de nuestra API REST en PHP puro. ¡Manos a la obra!

🔹 Problema inicial:
Al ingresar a la raíz de la API (/), aparece un mensaje genérico ("Hola, soy el archivo rutas"). Pero queremos mostrar un JSON estándar, como en otros frameworks:

php
echo json_encode(["detalle" => "no encontrado"]);

✅ Solución: Validamos la ruta raíz y devolvemos la respuesta en formato JSON.

🛠️ Configurando Rutas Dinámicas

Objetivo: Evitar crear carpetas físicas (como /registro o /cursos) y manejar todo mediante el enrutamiento.

🔧 Paso clave: Usar el archivo .htaccess para reescribir URLs:

apache
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?$1 [L,QSA]

Esto redirige todas las peticiones a index.php, donde procesamos la ruta con PHP.

📡 Capturando Rutas con PHP

Usamos $_SERVER['REQUEST_URI'] para obtener la URL solicitada y la dividimos en segmentos:

php
$rutas = explode("/", $_SERVER['REQUEST_URI']);
$rutas = array_filter($rutas);

Ejemplo de lógica para manejar rutas:

php
if (count($rutas) == 0) {
    echo json_encode(["detalle" => "no encontrado"]);
} elseif ($rutas[1] == "registro") {
    echo json_encode(["mensaje" => "Estoy en registro"]);
} elseif ($rutas[1] == "cursos" && !isset($rutas[2])) {
    echo json_encode(["mensaje" => "Lista de cursos"]);
} elseif ($rutas[1] == "cursos" && is_numeric($rutas[2])) {
    echo json_encode(["mensaje" => "Curso ID: " . $rutas[2]]);
}

🔍 Resultados:

  • / → {"detalle":"no encontrado"}

  • /registro → {"mensaje":"Estoy en registro"}

  • /cursos → {"mensaje":"Lista de cursos"}

  • /cursos/5 → {"mensaje":"Curso ID: 5"}

💡 Conclusión: Con PHP nativo y .htaccess, podemos crear un enrutamiento limpio y escalable, similar a los frameworks modernos.

¿Quieres ver el código completo? ¡Déjalo en los comentarios! 👇 #PHP #APIREST #BackendDev+


$arrayRutas = explode("/", $_SERVER['REQUEST_URI']);

if(count(array_filter($arrayRutas)) == 0){
    /*==============================================================
    Cuando no se hace ninguna petición a la API
    ---*/
    $json = array(
        "detalle"=>"no encontrado"
    );
    echo json_encode($json, true);
}
else{
    if(array_filter($arrayRutas)[1] == "registro"){
        $json = array(
            "detalle"=>"estoy en registro"
        );
        echo json_encode($json, true);
    }
if(array_filter($arrayRutas)[1] == "cursos"){
    $json = array(
        "detalle"=>"estoy en cursos"
    );
    echo json_encode($json, true);
}

}
Explicación del Código
Este código PHP parece ser parte de un sistema de enrutamiento básico para una API. Aquí está el análisis:
  1. División de la URL:
    • explode("/", $_SERVER['REQUEST_URI']) divide la URL solicitada en partes usando "/" como delimitador.
    • Por ejemplo, si la URL es api.com/registro, $arrayRutas contendrá ["", "registro"].
  2. Comprobación de ruta vacía:
    • array_filter($arrayRutas) elimina elementos vacíos del array.
    • Si no hay rutas después del filtrado (count == 0), devuelve un JSON con mensaje "no encontrado".
  3. Manejo de ruta "/registro":
    • Si el segundo elemento del array filtrado es "registro", devuelve un JSON con mensaje "estoy en registro".
    • Nota: Hay un error tipográfico en "no encontrado" (dice "no encontrado").

Comentarios

Publicar un comentario

Entradas más populares de este blog

token

  ¿Qué es un token? Un  token  es una cadena de caracteres que representa información específica, como credenciales de acceso, identificadores únicos o datos de sesión. Se utilizan comúnmente en: Autenticación y autorización (JWT, tokens de acceso) Protección CSRF (Cross-Site Request Forgery) Identificación única de recursos Contraseñas de un solo uso Ejemplo pequeño en PHP: Token de autenticación simple php <?php // Función para generar un token aleatorio function generarToken ( $longitud = 32 ) { return bin2hex ( random_bytes ( $longitud ) ) ; } // Generar un token $token = generarToken ( ) ; echo "Token generado: " . $token . "\n\n" ; // Simular verificación del token (en una aplicación real se guardaría en base de datos) function verificarToken ( $tokenAlmacenado , $tokenRecibido ) { return hash_equals ( $tokenAlmacenado , $tokenRecibido ) ; } // Ejemplo de uso $tokenAlmacenado = $token ; // En la práctica, esto ven...
Leer más

¿Qué es un token y cómo se utiliza en una API?

  ¿Qué es un token y cómo se utiliza en una API? ¿Qué es un token? Un  token  es una cadena de caracteres que actúa como credencial de acceso para autenticar y autorizar a un usuario o aplicación en una API. Funciona como una "llave digital" que permite acceder a recursos protegidos sin necesidad de compartir credenciales sensibles como usuario y contraseña en cada solicitud. Tipos comunes de tokens: JWT (JSON Web Token) : Token auto-contenido con información codificada Access Token : Para acceso a recursos Refresh Token : Para renovar access tokens expirados API Key : Clave simple de identificación Ejemplo con PHP usando JWT 1. Instalación de dependencias bash composer require firebase/php-jwt 2. Generar un token JWT php <?php require 'vendor/autoload.php' ; use Firebase \ JWT \ JWT ; use Firebase \ JWT \ Key ; class TokenManager { private $secretKey = "tu_clave_secreta_muy_segura" ; private $algorithm = 'HS256' ; ...
Leer más

Generación de Credenciales API

   Generación de Credenciales API Método 1: Credenciales básicas (API Key + Secret) php <?php // Generar credenciales seguras function generarCredencialesAPI ( ) { $api_key = bin2hex ( random_bytes ( 32 ) ) ; // 64 caracteres hexadecimales $api_secret = bin2hex ( random_bytes ( 64 ) ) ; // 128 caracteres hexadecimales return [ 'api_key' => $api_key , 'api_secret' => password_hash ( $api_secret , PASSWORD_DEFAULT ) ] ; } // Generar y guardar credenciales $credenciales = generarCredencialesAPI ( ) ; // Guardar en base de datos (ejemplo) // INSERT INTO api_credentials (api_key, api_secret_hash, created_at) // VALUES (:api_key, :api_secret, NOW()) ?> Método 2: Credenciales JWT php <?php use Firebase \ JWT \ JWT ; use Firebase \ JWT \ Key ; class JWTCredentials { private $secret_key ; public function __construct ( ) { $this -> secret_key = bin2hex ( r...
Leer más