Avanzado

TailwindPHP es un port 1:1 de TailwindCSS 4.x a PHP puro. Su principio rector es la fidelidad: el código reproduce el proyecto original de TypeScript archivo por archivo, con los mismos nombres y organización, para que cada comportamiento de TailwindCSS tenga un lugar claro en PHP y se puedan seguir los cambios originales sin conjeturas.

Todo lo que no forma parte del port de TailwindCSS vive en un único lugar claramente identificado: src/_tailwindphp/. Ese directorio contiene los auxiliares específicos de PHP: una reimplementación de las transformaciones Rust lightningcss (LightningCss.php), el minificador de CSS (CssMinifier.php) y los ports de bibliotecas complementarias (lib/: clsx, tailwind-merge, CVA) bajo el espacio de nombres TailwindPHP\Lib\*. Todo lo demás dentro de src/ corresponde a un archivo de TailwindCSS.

La corrección se verifica con la propia suite de pruebas de Tailwind. Los casos de prueba se extraen directamente de los archivos .test.ts de TailwindCSS y se ejecutan frente a la salida de PHP, de modo que cualquier desviación del comportamiento original falla de inmediato. El resultado es de 4,427 pruebas superadas (versión 1.7.0, frente a TailwindCSS v4.3.3), que cubren utilidades, variantes, directivas, plugins, CLI y las bibliotecas complementarias.

Páginas

• Arquitectura — el flujo de compilación (analizar → explorar → compilar → optimizar → minificar), la estructura del código fuente, el equivalente de lightningcss y la convención de marcadores @port-deviation.
• Caché y minificación — la caché de salida basada en archivos (cache, cacheTtl, clearCache()), la caché del estado del compilador (stateCacheFile) y lo que hace el minificador de CSS.
• Rendimiento y pruebas — optimizaciones específicas de PHP, cómo se verifica la paridad con TailwindCSS y el control de calidad del código.
• Compatibilidad y actualización — requisitos, la versión de TailwindCSS seguida, diferencias conocidas respecto a TailwindCSS y notas de actualización por versión.