Производителност и тестване

TailwindPHP поставя коректността на първо място. Когато промяна, специфична за PHP, ускорява работата, без да променя изхода, тя се прилага и се обозначава с @port-deviation:performance. Съответствието с TailwindCSS не се приема на доверие — то се проверява постоянно спрямо собствения набор от тестове на Tailwind.

Производителност

Портът PHP дава приоритет на съвпадението с изхода на TailwindCSS пред суровата пропускателна способност, а оригиналът на TypeScript остава по-бърз при всички положения — JIT на V8 компилира често изпълняваните пътища до машинен код по начин, който PHP не може да постигне. За CSS, генериран при всяка заявка или страница, използвайте повторно един компилатор (вижте generateExact()) и запазете състоянието му при създаване чрез stateCacheFile.

Няколко често изпълнявани пътя имат ръчно настроени оптимизации, които запазват идентичния изход:

• ast.php toCss() — натрупва фрагменти в масив и извиква implode веднъж, вместо да конкатенира низове многократно, както и използва предварително изчислени низове за отстъп.
• css-parser.php — сравнява символите директно, вместо да използва ord(), и следи дължините на буферите, вместо да преизчислява strlen().

И двете са документирани с @port-deviation:performance и проверяват резултатите спрямо набора от тестове — те не могат да променят генерирания CSS.

Бенчмаркове

Директорията benchmarks/ съдържа програма за сравнение. Стартирайте я така:

composer bench         # PHP vs TypeScript
composer bench:save    # write benchmarks/results.json

Примерни резултати при PHP 8.4.5 / Node.js v22.17.0 (Apple M1):

TypeScript е по-бърз при тези операции на ниско ниво, както се очаква. За генериране на CSS на цяла страница — реалният сценарий на употреба — производителността на PHP е достатъчна (около 14 ms на страница в примерното изпълнение). При многократно подаване на един и същ вход файловият кеш премахва разхода изцяло.

Тестване и съответствие

Тестовете гарантират, че портът PHP генерира същия изход като TailwindCSS. Два подхода работят заедно.

1. Тестове чрез извличане. Скриптовете в test-coverage/ анализират собствените файлове .test.ts на TailwindCSS и извличат тестовите случаи в JSON. След това PHPUnit подава тези случаи към TailwindPHP и сравнява изхода с очаквания CSS. Тъй като очакваните резултати идват директно от upstream, всяко отклонение в поведението на PHP се проявява като неуспешен тест. Тестовете обхващат сложните области: помощни класове, варианти, интеграция, функции CSS и тестове ui.spec на ниво браузър.

2. Ръчно пренесени модулни тестове. По-простите тестови файлове на TypeScript (AST, анализ на CSS, екраниране, анализ на кандидати, анализ на стойности, …) се пренасят директно в PHP и се съхраняват до съответния изходен код като *.test.php, като повтарят структурата и проверките на оригиналите.

Цикълът е извлечи → изпълни → провери: извлечете тестовете отново от актуалната референтна версия на TailwindCSS, изпълнете набора и всяко отклонение ще доведе до неуспех. Така портът остава синхронизиран с upstream и актуализация на TailwindCSS може да се провери автоматично, вместо чрез преглед. При отклонение CI се проваля.

composer extract   # re-extract test cases from the TailwindCSS reference
composer test      # run the full suite

Към издание 1.7.0 има 4,427 преминали теста (референтна версия TailwindCSS v4.3.3):

Качество на кода

Форматирането и статичният анализ се изпълняват чрез скриптовете Composer:

composer lint      # Pint --test  (check formatting)
composer format    # Pint         (fix formatting)
composer analyse   # PHPStan      (static analysis, level 4)
composer quality   # lint + analyse

PHPStan се изпълнява на ниво 4 (phpstan.neon), с кратък списък от игнорирани шаблони за динамичните форми на масиви, използвани от архитектурата, базирана на функции. Анализират се всички изходни файлове; тестовите файлове се изключват.

За структурата, която тези тестове проверяват, и местата, където са записани отклонения, вижте Архитектура.