Pokročilé

TailwindPHP je port TailwindCSS 4.x v poměru 1:1 do čistého PHP. Základním principem je věrnost: kódová základna kopíruje původní projekt TypeScript soubor po souboru — se stejnými názvy souborů i organizací — aby každé chování v TailwindCSS mělo zřejmé místo v PHP a změny v upstreamu bylo možné sledovat bez hádání.

Vše, co není součástí portu TailwindCSS, je na jednom jasně označeném místě: src/_tailwindphp/. Tento adresář obsahuje pomocné nástroje specifické pro PHP — novou implementaci transformací Rust lightningcss (LightningCss.php), minifikátor CSS (CssMinifier.php) a porty doprovodných knihoven (lib/: clsx, tailwind-merge, CVA) v prostoru názvů TailwindPHP\Lib\*. Všechno ostatní v src/ odpovídá souboru v TailwindCSS.

Správnost se ověřuje pomocí vlastní testovací sady Tailwind. Testovací případy se extrahují přímo ze souborů .test.ts projektu TailwindCSS a spouštějí se nad výstupem PHP, takže každá odchylka od původního chování se okamžitě projeví jako selhání. Výsledkem je 4,427 úspěšných testů (vydání 1.7.0, oproti TailwindCSS v4.3.3), které pokrývají utility, varianty, direktivy, pluginy, CLI a doprovodné knihovny.

Stránky

• Architektura — proces kompilace (parse → scan → compile → optimize → minify), uspořádání zdrojových souborů, ekvivalent lightningcss a konvence značek @port-deviation.
• Mezipaměť a minifikace — výstupní mezipaměť založená na souborech (cache, cacheTtl, clearCache()), mezipaměť stavu kompilátoru (stateCacheFile) a funkce minifikátoru CSS.
• Výkon a testování — optimalizace specifické pro PHP, ověřování shody s TailwindCSS a kontrola kvality kódu.
• Kompatibilita a upgrade — požadavky, sledovaná verze TailwindCSS, známé rozdíly oproti TailwindCSS a poznámky k upgradu pro každé vydání.