Pruebas de Integración PHP con Docker: Nivel Avanzado

Pruebas de Integración PHP con Docker: De Escenarios Básicos a Soluciones Industriales

Las pruebas de integración son una etapa críticamente importante del desarrollo que verifica la interacción entre varios componentes del sistema: la base de datos, la caché, las API externas y la propia lógica de negocio. En el mundo de PHP, donde las aplicaciones a menudo trabajan en conjunto con MySQL/PostgreSQL, Redis y servidores web, Docker se convierte en una herramienta indispensable para crear entornos de prueba aislados y reproducibles. En este artículo, exploraremos técnicas avanzadas de pruebas de integración para aplicaciones PHP utilizando Docker que te ayudarán a llevar la calidad del código al siguiente nivel.

¿Por qué Docker es el compañero ideal para las pruebas de integración de PHP?

Los enfoques tradicionales para las pruebas de integración a menudo sufren de problemas de entorno: las bases de datos pueden ser diferentes en la máquina local y en el servidor CI, los puertos están ocupados y las dependencias no coinciden. Docker resuelve estos problemas de forma radical:

\n
• Aislamiento: cada escenario de prueba se ejecuta en un contenedor limpio, eliminando los efectos secundarios de pruebas anteriores.
\n
• Reproducibilidad: las imágenes con versiones fijas de PHP, extensiones y servicios garantizan que las pruebas se ejecuten de la misma manera en cualquier máquina.
\n
• Paralelismo: puedes ejecutar varios conjuntos de pruebas simultáneamente, cada uno en su propio contenedor con una base de datos única.
\n
• Velocidad: herramientas modernas como Testcontainers o Docker Compose permiten levantar y destruir entornos en segundos.
\n

Para PHP, esto es especialmente relevante, ya que una aplicación típica interactúa con múltiples recursos externos, desde colas (RabbitMQ) hasta motores de búsqueda (Elasticsearch).

Configuración de un Entorno de Pruebas Multinivel con Docker Compose

El primer paso hacia las pruebas avanzadas es crear un docker-compose.yml flexible que incluya no solo PHP, sino también todos los servicios necesarios. Consideremos un ejemplo para una aplicación en Laravel/Symfony que utiliza MySQL, Redis y una API REST externa:

version: '3.8'\n\nservices:\n  php-test:\n    image: php:8.2-cli\n    volumes:\n      - ./:/app\n    working_dir: /app\n    environment:\n      - DB_HOST=mysql-test\n      - DB_DATABASE=test_db\n      - REDIS_HOST=redis-test\n      - API_BASE_URL=http://mock-api:8080\n    depends_on:\n      mysql-test:\n        condition: service_healthy\n      redis-test:\n        condition: service_started\n      mock-api:\n        condition: service_started\n\n  mysql-test:\n    image: mysql:8.0\n    environment:\n      MYSQL_ROOT_PASSWORD: root\n      MYSQL_DATABASE: test_db\n    healthcheck:\n      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]\n      interval: 5s\n      timeout: 3s\n      retries: 5\n\n  redis-test:\n    image: redis:7-alpine\n\n  mock-api:\n    image: wiremock/wiremock:latest\n    volumes:\n      - ./tests/mock-api:/home/wiremock\n

El punto clave es el uso de WireMock para simular API externas. Esto permite probar la integración con servicios que pueden no estar disponibles o ser inestables en el entorno de prueba. WireMock se ejecuta en un contenedor separado y devuelve respuestas predefinidas basadas en archivos de configuración JSON.

Para ejecutar las pruebas dentro de este entorno, utiliza el script:

#!/bin/bash\ndocker-compose -f docker-compose.test.yml up -d\ndocker-compose -f docker-compose.test.yml exec php-test vendor/bin/phpunit --testsuite=Integration\ndocker-compose -f docker-compose.test.yml down

Técnicas Avanzadas: Creación Dinámica de Contenedores y Ejecución en Paralelo

Cuando el proyecto crece, un docker-compose.yml estático puede convertirse en un cuello de botella. Aquí es donde la biblioteca Testcontainers (disponible para PHP a través del paquete testc