Preskočiť na obsah

Pokročilé

TailwindPHP je port TailwindCSS 4.x do čistého PHP v jazyku 1:1. Hlavnou zásadou je vernosť: kódová základňa kopíruje pôvodný projekt TypeScript súbor po súbore — s rovnakými názvami súborov aj organizáciou — aby malo každé správanie v TailwindCSS zjavné miesto v PHP a aby sa zmeny v nadradenom projekte dali sledovať bez dohadov.

Všetko, čo nie je súčasťou portu TailwindCSS, sa nachádza na jednom jasne označenom mieste: src/_tailwindphp/. Tento adresár obsahuje pomocné nástroje špecifické pre PHP — opätovnú implementáciu transformácií Rust lightningcss (LightningCss.php), minifikátor CSS (CssMinifier.php) a porty sprievodných knižníc (lib/: clsx, tailwind-merge, CVA) v priestore názvov TailwindPHP\Lib\*. Všetko ostatné v src/ zodpovedá súboru v TailwindCSS.

Správnosť sa overuje pomocou vlastnej testovacej sady Tailwind. Testovacie prípady sa získavajú priamo zo súborov .test.ts projektu TailwindCSS a spúšťajú sa nad výstupom PHP, takže každá odchýlka od pôvodného správania sa okamžite prejaví zlyhaním. Výsledkom je 4,427 úspešných testov (vydanie 1.7.0, oproti TailwindCSS v4.3.3), ktoré pokrývajú nástroje, varianty, direktívy, doplnky, CLI a sprievodné knižnice.

Stránky

  • Architektúra — proces kompilácie (analýza → skenovanie → kompilácia → optimalizácia → minifikácia), rozloženie zdrojových súborov, ekvivalent lightningcss a konvencia značiek @port-deviation.
  • Ukladanie do vyrovnávacej pamäte a minifikácia — súborová vyrovnávacia pamäť výstupu (cache, cacheTtl, clearCache()), vyrovnávacia pamäť stavu kompilátora (stateCacheFile) a činnosť minifikátora CSS.
  • Výkon a testovanie — optimalizácie špecifické pre PHP, overovanie zhody s TailwindCSS a kontrola kvality kódu.
  • Kompatibilita a aktualizácia — požiadavky, sledovaná verzia TailwindCSS, známe rozdiely oproti TailwindCSS a poznámky k aktualizáciám jednotlivých vydaní.