# Geavanceerd

TailwindPHP is een 1:1-port van TailwindCSS 4.x naar puur PHP. Het uitgangspunt is getrouwheid: de codebase bootst het oorspronkelijke TypeScript-project bestand voor bestand na — met dezelfde bestandsnamen en dezelfde indeling — zodat elk gedrag in TailwindCSS een duidelijke tegenhanger heeft in PHP en wijzigingen upstream zonder giswerk kunnen worden gevolgd.

Alles wat *geen* deel uitmaakt van de TailwindCSS-port staat op één duidelijk gemarkeerde plek: `src/_tailwindphp/`. Die map bevat de PHP-specifieke hulpfuncties: een herimplementatie van de Rust `lightningcss`-transformaties (`LightningCss.php`), de minifier van CSS (`CssMinifier.php`) en de companion library-ports (`lib/`: clsx, tailwind-merge, CVA) onder de `TailwindPHP\Lib\*`-namespace. Alles wat verder onder `src/` staat, komt overeen met een bestand in TailwindCSS.

De juistheid wordt gecontroleerd met de eigen testsuite van Tailwind. Testgevallen worden rechtstreeks uit de TailwindCSS-bestanden van `.test.ts` gehaald en uitgevoerd tegen de uitvoer van PHP, zodat elke afwijking van het oorspronkelijke gedrag meteen tot een fout leidt. Het resultaat: 4,427 tests slagen (release 1.7.0, tegen TailwindCSS v4.3.3), voor hulpfuncties, varianten, richtlijnen, plugins, de CLI en de companion libraries.

## Pagina's

- **[Architectuur](https://tailwindphp.inline0.dev/nl/docs/advanced/architecture)** — de compilatiepipeline (parsen → scannen → compileren → optimaliseren → minificeren), de broncode-indeling, het equivalent van `lightningcss` en de conventie voor `@port-deviation`-markeringen.
- **[Caching en minificatie](https://tailwindphp.inline0.dev/nl/docs/advanced/caching)** — de bestandsgebaseerde uitvoercache (`cache`, `cacheTtl`, `clearCache()`), de cache voor de compilerstatus (`stateCacheFile`) en wat de minifier van CSS doet.
- **[Prestaties en tests](https://tailwindphp.inline0.dev/nl/docs/advanced/performance)** — optimalisaties specifiek voor PHP, hoe de overeenkomst met TailwindCSS wordt gecontroleerd en de poort voor codekwaliteit.
- **[Compatibiliteit en upgrades](https://tailwindphp.inline0.dev/nl/docs/advanced/compatibility)** — vereisten, de bijgehouden versie van TailwindCSS, bekende verschillen met TailwindCSS en upgrade-opmerkingen per release.