TailwindPHP

TailwindPHP on 1:1 port TailwindCSS 4.x-ist PHP-i. See parsib sinu CSS, otsib märgendusest klassinimesid ja genereerib utiliidi-CSS, mida TailwindCSS v4.3.3 toodab — täielikult PHP-is, ilma Node.js-ta ja ehitussammuta.

• Puhas PHP — tarnitakse Composer paketina ja töötab versiooniga PHP 8.2+ ning standardsete laiendustega ctype ja mbstring. Ei mingit exec-i, FFI-t ega omamaiseid koostamistööriistu.
• Kontrollitud vastu TailwindCSS-i — utiliidid, variandid, direktiivid ja funktsioonid CSS järgivad TailwindCSS v4.3.3-i. Väljundit kontrollitakse Tailwind enda testikomplektide põhjal, mis eraldatakse lähtekoodist TypeScript ja käivitatakse uuesti igal üleslükkel (üle 4,400 testi). Teadaolevad erinevused (mõned kaskaadi mitte mõjutavad jadastuse üksikasjad ja avatud probleemid) on loetletud lehel Ühilduvus ja versiooniuuendused.
• Kõik funktsioonid kaasas — täielik TailwindCSS v4.3.3 utiliitide komplekt (sh container, kerimisriba utiliidid, zoom-* ja tab-*), kõik variandid (hõljutus, fookus, kohanduv paigutus, tume režiim, konteineripäringud, suvalised väärtused) ning kõik direktiivid: @import, @theme, @apply, @utility, @variant, @custom-variant, @layer, @plugin ja @source.
• Kõik vajalik kaasas — cn(), merge(), join() ja variants() sisaldavad clsx-i, tailwind-merge ja CVA PHP teisendusi, nii et levinud kaasnevad teegid, mida iga Tailwind projekt vajab, on juba olemas.
• Pluginad — @tailwindcss/typography ja @tailwindcss/forms on täielikult teisendatud ning PHP-plugin API võimaldab kirjutada oma pluginaid.

Miks TailwindPHP olemas on

TailwindCSS on kirjutatud keeles TypeScript ja töötab versioonis Node.js. See on vältimatu nõue iga PHP-projekti jaoks, mis soovib kasutada Tailwind-i: vaja läheb teist käituskeskkonda, paigaldust npm ning ehitusetappi CI-s ja Docker-is. Paljude PHP-rakenduste puhul on see lisatöö, mida eelistataks vältida.

TailwindPHP kõrvaldab selle vajaduse. Sinu PHP-kood kompileerib Tailwind CSS-i otse, kasutades ainult standardteeki. See võimaldab asju, mis JavaScript tööriistaahelaga on keerulised või võimatud:

• WordPress ja PHP raamistikud — loo Tailwind-põhiseid kujundusi ja pluginaid, palumata kasutajatel paigaldada Node.js-i ega midagi koostada. Lihtsalt composer require ja valmis. Vaata TailwindWP-i: see on näidis-WordPress plugin, mis genereerib plokiredaktori CSS-e TailwindPHP-iga.
• CSS käitusaegne genereerimine — loo utiliit-CSS-e käigu pealt kasutaja sisendi, andmebaasi sisu või mallimuutujate põhjal, mitte koostamise ajal.
• Lihtsam juurutamine — tootmiskeskkonnas pole Node.js-i ega CI-s ehitusetappi; sinu Docker-kujutisse ei lisata ka npm-i.

See on sama idee, mille scssphp tõi SCSS-i — täielik kompilaator PHP-is.

Mida see teeb

• Kompileerib sisust leitud klassinimede põhjal TailwindCSS v4.3.3 abiklassid, variandid ja suvalised väärtused.
• Lahendab kõik direktiivid: @import (sealhulgas virtuaalsed moodulid nagu tailwindcss ja tailwindcss/utilities ning reference-impordid), @theme, @apply, @utility, @variant, @custom-variant, @layer, @plugin ja @source.
• Rakendab CSS-funktsioonid, mida pakub Tailwind — theme(), --theme(), --spacing() ja --alpha() —, lisaks teisenduse color-mix() → oklab() ning CSS-teisendused, mille TailwindCSS delegeerib LightningCSS-ile.
• Lahendab @import direktiivi failisüsteemist pesastatud importide, duplikaatide eemaldamise ja kohandatud lahendajatega või tekstisiseselt antud CSS-stringidest.
• Sisaldab Preflighti (baasstiilide lähtestus, mida pakub Tailwind), prefiksite tuge, @property varulahendusi, brauseriprefikseid ja võtmekaadrite definitsioonide kõrgemale tõstmist.
• Sisaldab funktsioone cn(), merge(), join() ja variants()/compose() klassinimede koostamiseks, konfliktide lahendamiseks ja komponentide variantide määramiseks.
• Sisaldab tüpograafia- ja vormipluginaid ning pluginate API-t (addUtilities, matchUtilities, addComponents, addVariant, theme, …) kohandatud pluginate jaoks.
• Pakub CLI-d (bin/tailwindphp) koos @tailwindcss/cli ehitusvalikutega, failipõhise väljundivahemälu, püsiva kompilaatorioleku vahemälu ja tootmiskeskkonna CSS-minimeerijaga.

Mis see ei ole

TailwindPHP on CSS kompilaator, mitte redaktori tööriistakomplekt. See jätab teadlikult välja Tailwind ökosüsteemi IDE-le suunatud osad — IntelliSense, automaattäitmise, klasside sortimise ja lähtekaardid — sest need on redaktori funktsioonid, mitte osa CSS genereerimisest. Kõik, mis toodab CSS, kuulub siia; kõik, mis redaktorit toidab, jääb välja.

Kust alustada

• Alustamine — installige pakett ja genereerige oma esimene stiilitabel.
• Kasutamine — skannige sisu, kohandage teemat ja kasutage Tailwind direktiive.
• Klassiutiliidid — cn(), merge(), join() ja variants().
• Pluginad — tüpograafia, vormid ja oma plugina kirjutamine.
• API — kogu tw pind ja TailwindCompiler eksemplar.
• CLI — bin/tailwindphp failipõhiste järkude ja jälgimisrežiimi jaoks.
• Täpsemad teemad — arhitektuur, vahemällu salvestamine, jõudlus ja ühilduvuse märkused.