# Lisäasetukset

TailwindPHP on TailwindCSS 4.x -ohjelman suora 1:1-siirros puhtaaksi PHP-koodiksi. Ohjaavana periaatteena on uskollisuus: koodikanta vastaa alkuperäistä TypeScript-projektia tiedosto tiedostolta, samoilla tiedostonimillä ja samalla rakenteella. Näin jokaiselle TailwindCSS-ohjelman toiminnolle löytyy selkeä vastine kohteesta PHP, ja ylävirran muutoksia voi seurata arvailematta.

Kaikki, mikä ei kuulu TailwindCSS-porttiin, sijaitsee yhdessä selkeästi merkityssä paikassa: `src/_tailwindphp/`. Hakemisto sisältää PHP-kohtaiset apufunktiot — uudelleentoteutuksen Rustn `lightningcss`-muunnoksista (`LightningCss.php`), CSS-pienentäjän (`CssMinifier.php`) sekä kumppanikirjastojen porttaukset (`lib/`: clsx, tailwind-merge, CVA) `TailwindPHP\Lib\*`-nimiavaruudessa. Kaikki muu hakemistossa `src/` vastaa tiedostoa hakemistossa TailwindCSS.

Oikeellisuus varmistetaan Tailwindn omalla testisarjalla. Testitapaukset poimitaan suoraan TailwindCSSn `.test.ts`-tiedostoista ja suoritetaan PHP-tulostetta vasten, joten kaikki poikkeamat alkuperäisestä toiminnasta havaitaan heti. Julkaisussa 1.7.0 läpäistään 4,427 testiä (TailwindCSS v4.3.3), jotka kattavat apufunktiot, variantit, direktiivit, lisäosat, CLIn ja kumppanikirjastot.

## Sivut

- **[Arkkitehtuuri](https://tailwindphp.inline0.dev/fi/docs/advanced/architecture)** — käännösputki (jäsennys → skannaus → käännös → optimointi → pienennys), lähdekoodin rakenne, `lightningcss`-vastine ja `@port-deviation`-merkkikäytäntö.
- **[Välimuisti ja pienennys](https://tailwindphp.inline0.dev/fi/docs/advanced/caching)** — tiedostopohjainen tulostevälimuisti (`cache`, `cacheTtl`, `clearCache()`), kääntäjän tilavälimuisti (`stateCacheFile`) ja se, mitä CSS-pienentäjä tekee.
- **[Suorituskyky ja testaus](https://tailwindphp.inline0.dev/fi/docs/advanced/performance)** — PHP-kohtaiset optimoinnit, miten vastaavuus TailwindCSSn kanssa varmistetaan ja koodin laadun tarkistus.
- **[Yhteensopivuus ja päivitykset](https://tailwindphp.inline0.dev/fi/docs/advanced/compatibility)** — vaatimukset, seurattu TailwindCSS-versio, tunnetut erot TailwindCSSsta ja julkaisukohtaiset päivityshuomiot.