Microservicios en PHP: arquitectura y práctica de la A a la Z

Entrenador de Python en Línea para Principiantes

Aprende Python fácilmente sin sobrecargarte de teoría. Resuelve tareas prácticas con verificación automática, recibe pistas y escribe código directamente en el navegador, sin instalar nada.

Start Course

Introducción: ¿Por qué PHP y microservicios?

Durante mucho tiempo, PHP se asoció exclusivamente con aplicaciones monolíticas — WordPress, Laravel o Symfony. Sin embargo, el PHP moderno (a partir de la versión 7.4 y especialmente 8.x) se ha convertido en una herramienta poderosa para construir arquitecturas de microservicios. Gracias a su rendimiento mejorado, tipado estricto, capacidades asíncronas (a través de ReactPHP o Swoole) y un ecosistema maduro, PHP se ha convertido en un lenguaje completo para microservicios.

En este artículo analizaremos: qué son los microservicios en PHP, cómo diseñar una arquitectura, qué tecnologías usar, y escribiremos ejemplos de código reales.

¿Qué es la arquitectura de microservicios?

Los microservicios son un enfoque en el que una aplicación se divide en servicios pequeños e implementados de forma independiente. Cada servicio es responsable de su propia función de negocio y se comunica con otros a través de la red (HTTP/REST, gRPC, colas de mensajes).

Principios clave de los microservicios en PHP

Independencia — cada servicio puede estar escrito en PHP, Node.js o Go, pero nosotros usamos PHP para todos.
Descentralización de datos — cada base de datos pertenece a un solo servicio.
Orquestación vs Coreografía — elección entre gestión centralizada (Kubernetes) y un enfoque orientado a eventos.
Tolerancia a fallos — un servicio caído no debe derribar todo el sistema.

Arquitectura de microservicios en PHP: de la teoría a la práctica

Consideremos un proyecto típico: una tienda online. Lo dividiremos en microservicios:

User Service — registro, autenticación, perfiles.
Product Service — catálogo de productos, precios, existencias.
Order Service — creación de pedidos, estados.
Payment Service — procesamiento de pagos.
Notification Service — notificaciones por email/SMS.

Paso 1: Diseño del API Gateway

API Gateway — punto de entrada único. En PHP se puede implementar con Slim Framework o usando Nginx + PHP-FPM. Ejemplo de un gateway simple con Slim 4:

<?php// api-gateway/public/index.phpuse Slim\\Factory\\AppFactory;use Psr\\Http\\Message\\ServerRequestInterface as Request;use Psr\\Http\\Message\\ResponseInterface as Response;

require __DIR__ . '/../vendor/autoload.php';

$app = AppFactory::create();

// Enrutamiento a microservicios$app->post('/api/orders', function (Request $request, Response $response) {    // Redirigimos la solicitud al Order Service    $client = new GuzzleHttp\\Client(['base_uri' => 'http://order-service:8080']);    $res = $client->post('/orders', [        'json' => $request->getParsedBody()    ]);    $response->getBody()->write($res->getBody());    return $response->withStatus($res->getStatusCode());});

$app->run();

Paso 2: Comunicación síncrona (REST)

La forma más simple son las peticiones HTTP entre servicios. Usamos Guzzle o Symfony HttpClient. Ejemplo de Product Service:

<?php// product-service/src/Controller/ProductController.phpnamespace App\\Controller;

use Symfony\\Component\\HttpFoundation\\JsonResponse;use Symfony\\Component\\HttpFoundation\\Request;

class ProductController{    public function getProduct(int $id): JsonResponse    {        // Lógica para obtener el producto de la BD        $product = $this->productRepository->find($id);                if (!$product) {            return new JsonResponse(['error' => 'Product not found'], 404);        }                return new JsonResponse([            'id' => $product->getId(),            'name' => $product->getName(),            'price' => $product->getPrice()        ]);    }}