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.
Perfiles verificables: Sitio web
Publicado el 29 de October de 2026. Última revisión: 29 de October de 2026.