Lanjutan

Lihat sebagai Markdown Edit di GitHub Dokumentasi di 3843abd

TailwindPHP adalah port 1:1 dari TailwindCSS 4.x ke PHP murni. Prinsip utamanya adalah kesetiaan: basis kode mencerminkan proyek TypeScript asli file demi file — nama file dan susunannya sama — sehingga setiap perilaku di TailwindCSS memiliki padanan yang jelas di PHP, dan perubahan upstream dapat dilacak tanpa menebak-nebak.

Apa pun yang bukan bagian dari port TailwindCSS berada di satu tempat yang ditandai jelas: src/_tailwindphp/. Direktori itu berisi helper khusus PHP — implementasi ulang transformasi Rust lightningcss (LightningCss.php), minifier CSS (CssMinifier.php), dan port pustaka pendamping (lib/: clsx, tailwind-merge, CVA) di namespace TailwindPHP\Lib\*. Semua yang lain di dalam src/ berpadanan dengan file di TailwindCSS.

Kebenaran diverifikasi menggunakan rangkaian pengujian milik Tailwind sendiri. Kasus pengujian diekstrak langsung dari file .test.ts milik TailwindCSS dan dijalankan terhadap keluaran PHP, sehingga setiap penyimpangan dari perilaku asli langsung menyebabkan kegagalan. Hasilnya, 4,427 pengujian lulus (rilis 1.7.0, terhadap TailwindCSS v4.3.3), mencakup utilitas, varian, direktif, plugin, CLI, dan pustaka pendamping.

Halaman

Arsitektur — pipeline kompilasi (parse → scan → compile → optimize → minify), tata letak sumber, padanan lightningcss, dan konvensi penanda @port-deviation.
Caching & minifikasi — cache keluaran berbasis file (cache, cacheTtl, clearCache()), cache status compiler (stateCacheFile), dan fungsi minifier CSS.
Performa & pengujian — optimasi khusus PHP, cara memverifikasi kesetaraan dengan TailwindCSS, dan gerbang kualitas kode.
Kompatibilitas & peningkatan — persyaratan, versi TailwindCSS yang dilacak, perbedaan yang diketahui dari TailwindCSS, dan catatan peningkatan untuk setiap rilis.