Informática y Software Práctico

XAMPP crear API REST PHP: el error de las rutas que nadie te cuenta

Post actualizado el día octubre 29, 2026 by DeiviSanzPlay

XAMPP crear API REST PHP suena sencillo hasta que el primer GET /productos devuelve 404 aunque el archivo exista. Ese fallo de rutas es la duda real que frena a mucha gente: Apache no sabe que /productos debe ir a index.php porque no hay un archivo físico con ese nombre. La solución pasa por un .htaccess con reglas de reescritura y un front controller que lea $_SERVER[‘REQUEST_URI’].

Lo primero es decidir dónde vive el proyecto. Si trabajas en htdocs/miapi, la URL base será http://localhost/miapi/. Dentro crea public/index.php como único punto de entrada. Todos los endpoints salen de ahí, no de archivos sueltos como productos.php o login.php. Esta decisión evita el caos de tener que configurar reescrituras distintas para cada recurso.

Cómo estructurar el front controller en XAMPP

El index.php recibe la petición, extrae la ruta y el método HTTP, y despacha al controlador correspondiente. Un ejemplo mínimo:

$uri = parse_url($_SERVER[‘REQUEST_URI’], PHP_URL_PATH); $uri = str_replace(‘/miapi/public’, », $uri); $method = $_SERVER[‘REQUEST_METHOD’]; if ($uri === ‘/productos’ && $method === ‘GET’) { require __DIR__ . ‘/../app/productos.php’; }

Ese str_replace es clave: en producción la ruta base desaparece, pero en local sigue estando. Si no lo normalizas, las mismas reglas no funcionan en ambos entornos. Es un detalle que se olvida y genera horas de depuración.

Para el .htaccess, dos líneas bien puestas resuelven el 404:

RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^ index.php [QSA,L]

Colócalo en public/, no en la raíz del proyecto. Y confirma que en httpd.conf está activo mod_rewrite y que AllowOverride All aparece en el bloque de htdocs. Sin AllowOverride, el .htaccess se ignora en silencio, y ahí empieza la frustración.

El mito del servidor embebido de PHP

Muchos tutoriales de API REST en PHP con XAMPP recomiendan php -S localhost:8000 -t public. Funciona, pero no reproduce el comportamiento de Apache ni procesa .htaccess. Si tu API depende de cabeceras o reescrituras, prueba siempre con Apache activo desde el panel de control de XAMPP.

Otro punto donde la gente tropieza: las respuestas JSON. Añade header(‘Content-Type: application/json; charset=utf-8’) antes de cualquier echo, y devuelve siempre el mismo formato de error. Un cliente que recibe {«error»:»…»} en un 400 y HTML en un 500 rompe cualquier integración.

Esto no funciona para todo

XAMPP crear API REST PHP no sirve para producción ni para entornos con alta concurrencia. Apache con mod_php arrastra procesos pesados y el panel de XAMPP está pensado para desarrollo local. Si tu API va a recibir tráfico real, migra a Nginx con PHP-FPM o a un framework con enrutador propio como Laravel o Slim.

Tampoco funciona bien para APIs con autenticación OAuth compleja o websockets: para eso necesitas un servidor específico y no el Apache de XAMPP. Reconocer esos límites antes de empezar ahorra refactorizaciones dolorosas.

Conexión a MySQL y errores frecuentes

El usuario por defecto de MySQL en XAMPP es root sin contraseña, algo que en local vale pero que debes cambiar antes de exponer el equipo en una red. Usa PDO con sentencias preparadas; no concatenes parámetros en la consulta. Un ejemplo de conexión mínima con manejo de excepciones:

$pdo = new PDO(‘mysql:host=localhost;dbname=tienda;charset=utf8mb4’, ‘root’, », [ PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC ]);

Si la API devuelve datos con acentos rotos, revisa el charset=utf8mb4 tanto en PDO como en la tabla. Es el fallo más común al montar un endpoint de búsqueda con XAMPP y PHP.

Probar los endpoints sin Postman

Puedes validar con curl desde la terminal: curl -i http://localhost/miapi/public/productos. La opción -i muestra cabeceras de estado, y ahí ves si Apache responde 200 o 404 antes de tocar el código PHP. Es la forma más rápida de separar un problema de enrutamiento de uno de lógica.

Documenta cada endpoint con su método, ruta y ejemplo de respuesta en un archivo README.md dentro del proyecto. No es burocracia: cuando vuelves semanas después, esas notas ahorran reconstruir mentalmente el enrutador. La documentación oficial de Apache sobre mod_rewrite y la de PHP sobre PDO son las fuentes que conviene consultar cuando algo no encaja.


Sobre el autor: DeiviSanzPlay — Soy David Sanz, Editor y Responsable de Contenidos. Mi trabajo consiste en revisar, corregir y mejorar los contenidos de este blog para que la información sea clara, útil y esté bien estructurada. Trabajo con diferentes temáticas y verticales, por lo que una parte importante de mi día a día es analizar cada contenido, cuidar la redacción y asegurar que el lector encuentre información de calidad. Me gusta prestar atención a los detalles. Desde una corrección de estilo hasta la organización de un artículo, todo cuenta cuando se trata de crear contenidos que realmente aporten valor y sean fáciles de entender. En este blog encontrarás artículos sobre diferentes temas y sectores. Mi responsabilidad es cuidar y supervisar cada contenido para que mantenga unos estándares de calidad y ofrezca una buena experiencia a quien nos visita. Porque para mí, un buen contenido no consiste únicamente en escribir. También hay que revisar, contrastar, ordenar y pensar en la persona que está al otro lado de la pantalla.

Perfiles verificables: Sitio web

Publicado el 29 de October de 2026. Última revisión: 29 de October de 2026.