Розширене

Переглянути як Markdown Редагувати на GitHub Документація для 3843abd

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 і супутні бібліотеки.

Сторінки

Архітектура — конвеєр компіляції (розбір → сканування → компіляція → оптимізація → мініфікація), структура вихідного коду, еквівалент lightningcss і домовленість щодо маркерів @port-deviation.
Кешування та мініфікація — файловий кеш результатів (cache, cacheTtl, clearCache()), кеш стану компілятора (stateCacheFile) і робота мініфікатора CSS.
Продуктивність і тестування — оптимізації для PHP, перевірка відповідності TailwindCSS і контроль якості коду.
Сумісність і оновлення — вимоги, відстежувана версія TailwindCSS, відомі відмінності від TailwindCSS та примітки до оновлення кожного випуску.