--- title: "Desarrollo local y pruebas" description: "Prepara el desarrollo local de Éclair: servidor PHP integrado, 550 comprobaciones automáticas, archivo ZIP, Lighthouse, depuración y MCP Inspector." url: "https://eclair.academy/es/rutas/experto/desarrollo-local" lang: "es" author: "Thierry Gustin" published: "2026-11-02" updated: "2026-11-02" --- # Desarrollo local y pruebas > **Lo esencial** — Para el desarrollo local de Éclair, clona el repositorio de GitHub y lanza PHP_CLI_SERVER_WORKERS=4 php -S localhost:8000 -t eclair tools/router.php. El comando php tests/run.php ejecuta 550 comprobaciones unitarias y HTTP, php tools/build.php genera el archivo de distribución y sus huellas, y eclair-config.php activa el modo de depuración. El desarrollo local de Éclair no pide Composer, ni base de datos, ni contenedor: basta con PHP 8.1 o superior. En esta lección ejecutas el sitio en tu máquina, lanzas las 550 comprobaciones automáticas, construyes el archivo de distribución, mides con Lighthouse y pruebas el conector MCP antes de tocar un sitio en línea. > **Antes de empezar** — Duración: 45 minutos. Requisitos: PHP 8.1 o superior en línea de comandos (se recomienda 8.3) con las extensiones vistas en [Preparar la instalación](https://eclair.academy/es/rutas/principiante/preparar-instalacion), más curl para las pruebas HTTP y zip para el archivo de distribución; Git; Node.js 22.19 o superior para Lighthouse y MCP Inspector. Lee primero [La arquitectura de Éclair](https://eclair.academy/es/rutas/experto/arquitectura). ## Lo que sabrás hacer ### 🚀 Ejecutar Éclair en local El servidor integrado de PHP, con el enrutador del repositorio. ### ✅ Probar antes de entregar Comprobaciones unitarias, HTTP y del renderizado público, byte a byte. ### 🔧 Depurar con método eclair-config.php, registro de errores y MCP Inspector. ## Lanzar Éclair en desarrollo local ```bash git clone https://github.com/Jacckisback/eclair-cms.git cd eclair-cms PHP_CLI_SERVER_WORKERS=4 php -S localhost:8000 -t eclair tools/router.php ``` La opción `-t eclair` convierte la carpeta `eclair/` en la raíz del sitio, como la carpeta pública de un hosting. El script `tools/router.php` reproduce las reglas del `.htaccess`: 404 para `app/`, `data/`, `cache/`, los archivos ocultos y cualquier `.php` distinto de `index.php`, y ningún script ni página en `media/`. Sirve tal cual los archivos existentes y envía todo lo demás a `index.php`. ¿Por qué `PHP_CLI_SERVER_WORKERS=4`? Para verificar su dirección, el sitio se llama a sí mismo en `/__eclair/ping`. Con un solo proceso, el servidor integrado está ocupado con la petición en curso y no puede responder: la verificación falla y las redirecciones a la dirección oficial siguen desactivadas. PHP no admite varios procesos en Windows: usa WSL o acepta una dirección sin verificar en local. Después abre `http://localhost:8000`: arranca el asistente de instalación, con el mismo plazo de 2 horas que en línea. Usa siempre la misma dirección (`localhost` o `127.0.0.1`): es la que guarda la instalación. Tus datos locales van a `eclair/data/`, que Git ignora, igual que la caché, las imágenes subidas y `eclair-config.php`. | Carpeta del repositorio | Contenido | | --- | --- | | `eclair/` | el CMS, tal como se sube a un hosting | | `i18n/` | fuentes legibles de las traducciones de la administración | | `tests/` | pruebas unitarias y HTTP, proveedores de IA simulados, sitios de referencia | | `tools/` | enrutador de desarrollo, construcción, captura, traducciones | | `docs/` | guía oficial en 7 idiomas | | `dist/` | archivos de distribución, uno por versión | > **Volver a un sitio en blanco** — `git clean -fdX eclair/` borra todo lo que Git ignora en `eclair/`: datos, caché, imágenes subidas y `eclair-config.php`. Los archivos con seguimiento, como `data/.htaccess`, se quedan en su sitio. ## ¿Cómo se lanzan las pruebas de Éclair? ```bash php tests/run.php # unitarias + integración HTTP # ✅ 550 vérifications réussies php tests/run.php --unit # solo unitarias, en pocos segundos # ✅ 241 vérifications réussies # La misma batería de pruebas sobre un archivo descomprimido ECLAIR_TEST_ROOT=/tmp/archive/eclair php tests/run.php ``` Las herramientas del repositorio muestran sus mensajes en francés, como la línea «550 vérifications réussies» (550 comprobaciones superadas). Las pruebas no tocan tu sitio de desarrollo local: los datos de las pruebas unitarias van a la carpeta temporal del sistema. Cada prueba HTTP copia `eclair/` en esa misma carpeta, vacía sus datos, lanza `php -S` en un puerto al azar con cuatro procesos y `tools/router.php`, instala un sitio y después repite sus escenarios con curl. Si algo falla, se muestra la lista de comprobaciones fallidas y el comando termina con el código 1: se integra tal cual en una cadena de integración continua. | Archivo | Lo que comprueba | | --- | --- | | `tests/run.php` | saneamiento contra XSS, slugs, verificación en dos pasos, bloques; instalación, cabeceras, caché y 304, redirecciones, protección contra la fuerza bruta, recuperación por FTP; renderizado público idéntico a la referencia | | `tests/ai.php` | asistente IA de principio a fin, con proveedores simulados | | `tests/shop.php` | temas, CSS personalizado, tienda, enlaces de Stripe, PayPal y Revolut, feed de Merchant Center | | `tests/mcp.php` | conector MCP: descubrimiento OAuth, PKCE, tokens, herramientas, revocación | | `tests/design.php` | direcciones de arte, contrastes, tipografías, puntuación de diseño | | `tests/fixtures/` | 4 sitios de referencia y huellas de su renderizado público | ### Desarrollar el asistente IA sin clave ni gasto `tests/fake-ai.php` imita las API de Anthropic, OpenAI, FLUX e Ideogram. Las pruebas lo lanzan en un puerto local y escriben en su copia un `eclair-config.php` que define `ECLAIR_AI_ENDPOINTS`. Puedes reproducir este montaje para trabajar en la interfaz del asistente: ```bash # Terminal 1: proveedores simulados (registro de peticiones en /tmp/fake-ai/log.jsonl) mkdir -p /tmp/fake-ai FAKE_AI_DIR=/tmp/fake-ai php -S 127.0.0.1:9999 tests/fake-ai.php ``` ```php 'http://127.0.0.1:9999', 'openai' => 'http://127.0.0.1:9999']); ``` El servidor simulado solo acepta sus claves de prueba, como `sk-ant-test-0123456789`, y reacciona a una palabra clave incluida en tu petición: `ARTICLE` (imagen y después borrador), `EQUIPE` (alta de un miembro) o `PIEGE` (texto malicioso), entre otras. ## Construir el archivo de distribución ```bash php tools/build.php # ✓ Traductions : 6 langues compilées (eclair/app/lang) # ✓ Empreintes : 126 fichiers (app/manifest.php) # ✓ Archive : …/dist/eclair-cms-1.8.0.zip (479 Ko, 981 991 octets une fois décompressée) ``` La versión sale de la constante `ECLAIR_VERSION` de `eclair/index.php`. El script vuelve a compilar las traducciones, calcula la huella SHA-256 de cada archivo (sus primeros 128 bits) en `app/manifest.php`, la base del control de integridad, y después crea `dist/eclair-cms-.zip`. Dentro del ZIP, el PHP se compacta con `php -w`, las vistas de la administración se comprimen (`.php.gz`, que se leen con zlib) y el JavaScript y el CSS de la administración se aligeran. El renderizado público sigue idéntico byte a byte. El contenido de `data/`, `cache/` y `media/` y tu `eclair-config.php` quedan fuera, mientras que se añaden `LISEZ-MOI.txt`, `LICENSE.txt` y `THIRD-PARTY-NOTICES.txt`. Sin la extensión zip, no se crea ningún ZIP. > **El manifiesto cambia** — La construcción reescribe `eclair/app/manifest.php` en tu copia de trabajo: Git lo verá modificado. Lánzala a propósito, en el momento de publicar una versión. ## Capturar el renderizado y medir con Lighthouse ```bash npm install -g lighthouse # Node.js 22 o superior php tools/capture.php # huellas del renderizado → tests/fixtures/public-.json php tools/capture.php --lighthouse # Lighthouse en móvil → tests/fixtures/lighthouse-.json ``` `tools/capture.php` sirve los cuatro sitios de referencia de `tests/fixtures/sites/` (blog, business, freelance, landing) y guarda la huella de cada página, primero para un visitante y después con una sesión de administración, además del HTML de cada bloque y de los archivos CSS y JS públicos. `tests/run.php` compara el renderizado actual con `public-1.6.0.json`: una versión nueva no debe cambiar ni un byte del sitio público. La opción `--reinstall` vuelve a crear los sitios de partida y, por tanto, huellas nuevas: las referencias existentes dejan de valer. Con `--lighthouse`, la herramienta mide en móvil la página de inicio y un artículo del sitio «business», la página «landing» y después la página de inicio con cuatro direcciones de arte, y se queda con la mediana de tres pasadas. Las variables `LIGHTHOUSE` y `CHROME_PATH` indican el comando y el navegador. En Éclair 1.8, cada página medida obtiene 100 en las cuatro categorías, con un LCP de 779 a 885 ms, un CLS de 0 y un TBT de 0 a 17 ms. ## Modo de depuración y eclair-config.php Copia `eclair/eclair-config.exemple.php` con el nombre `eclair-config.php`, junto a `index.php`, y deja solo las líneas útiles. Este es el modelo, completado con la constante `ECLAIR_SECRET`: ```php