# 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](https://tailwindphp.inline0.dev/hu/docs/advanced/architecture)** — 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](https://tailwindphp.inline0.dev/hu/docs/advanced/caching)** — 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](https://tailwindphp.inline0.dev/hu/docs/advanced/performance)** — 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](https://tailwindphp.inline0.dev/hu/docs/advanced/compatibility)** — 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.