# Розширене

TailwindPHP — це порт TailwindCSS 4.x на чистому PHP з відповідністю 1:1. Головний принцип — точність: кодова база відтворює оригінальний проєкт TypeScript файл за файлом — із тими самими назвами файлів і тією самою організацією. Завдяки цьому кожна поведінка TailwindCSS має очевидне відповідне місце в PHP, а зміни в основному проєкті можна відстежувати без здогадок.

Усе, що *не* належить до порту TailwindCSS, міститься в одному чітко позначеному місці: `src/_tailwindphp/`. У цьому каталозі розміщено допоміжні засоби, специфічні для PHP: повторну реалізацію перетворень Rust `lightningcss` (`LightningCss.php`), мініфікатор CSS (`CssMinifier.php`) і порти супутніх бібліотек (`lib/`: clsx, tailwind-merge, CVA) у просторі назв `TailwindPHP\Lib\*`. Кожному іншому файлу в `src/` відповідає файл у TailwindCSS.

Коректність перевіряється за власним набором тестів Tailwind. Тестові випадки безпосередньо видобуваються з файлів `.test.ts` проєкту TailwindCSS і запускаються проти результату PHP, тож будь-яке відхилення від оригінальної поведінки одразу виявляється. Результат — 4,427 успішних тестів (випуск 1.7.0, за еталоном TailwindCSS v4.3.3), що охоплюють утиліти, варіанти, директиви, плагіни, CLI і супутні бібліотеки.

## Сторінки

- **[Архітектура](https://tailwindphp.inline0.dev/uk/docs/advanced/architecture)** — конвеєр компіляції (розбір → сканування → компіляція → оптимізація → мініфікація), структура вихідного коду, еквівалент `lightningcss` і домовленість щодо маркерів `@port-deviation`.
- **[Кешування та мініфікація](https://tailwindphp.inline0.dev/uk/docs/advanced/caching)** — файловий кеш результатів (`cache`, `cacheTtl`, `clearCache()`), кеш стану компілятора (`stateCacheFile`) і робота мініфікатора CSS.
- **[Продуктивність і тестування](https://tailwindphp.inline0.dev/uk/docs/advanced/performance)** — оптимізації для PHP, перевірка відповідності TailwindCSS і контроль якості коду.
- **[Сумісність і оновлення](https://tailwindphp.inline0.dev/uk/docs/advanced/compatibility)** — вимоги, відстежувана версія TailwindCSS, відомі відмінності від TailwindCSS та примітки до оновлення кожного випуску.