Haladó

A TailwindPHP a TailwindCSS 4.x tisztán PHP nyelvre készített 1:1 portja. Az alapelv a hűség: a kódbázis fájlról fájlra tükrözi az eredeti TypeScript projektet — ugyanazokkal a fájlnevekkel és felépítéssel —, így a TailwindCSS minden viselkedésének megvan a nyilvánvaló megfelelője a PHP rendszerben, az upstream változásai pedig találgatás nélkül követhetők.

Minden, ami nem része a TailwindCSS portnak, egyetlen, jól megjelölt helyen található: src/_tailwindphp/. Ez a könyvtár tartalmazza a PHP-specifikus segédfüggvényeket — a Rust lightningcss transzformációinak újraimplementálását (LightningCss.php), a CSS minifikálóját (CssMinifier.php), valamint a kísérő könyvtárak portjait (lib/: clsx, tailwind-merge, CVA) a TailwindPHP\Lib\* névtér alatt. A src/ könyvtárban minden más fájlnak megfelel egy fájl a TailwindCSS könyvtárban.

A helyességet a Tailwind saját tesztcsomagjával ellenőrizzük. A teszteseteket közvetlenül a TailwindCSS .test.ts fájljaiból nyerjük ki, majd a PHP kimenetén futtatjuk őket, így az eredeti viselkedéstől való bármilyen eltérés azonnal hibát okoz. Az eredmény 4,427 sikeres teszt (1.7.0 kiadás, a TailwindCSS v4.3.3 alapján), amelyek a segédfüggvényeket, variánsokat, direktívákat, bővítményeket, a CLI elemet és a kísérő könyvtárakat fedik le.

Oldalak

• Architektúra — a fordítási folyamat (parse → scan → compile → optimize → minify), a forráskód felépítése, a lightningcss megfelelője és a @port-deviation jelölési konvenció.
• Gyorsítótárazás és minifikálás — a fájlalapú kimeneti gyorsítótár (cache, cacheTtl, clearCache()), a fordító állapotának gyorsítótára (stateCacheFile), valamint a CSS minifikáló működése.
• Teljesítmény és tesztelés — a PHP-specifikus optimalizálások, a TailwindCSS rendszerrel való egyezés ellenőrzése és a kódminőségi kapu.
• Kompatibilitás és frissítés — követelmények, a követett TailwindCSS-verzió, az ismert eltérések a TailwindCSS rendszertől, valamint a kiadásonkénti frissítési megjegyzések.