Preskoči na vsebino

TailwindPHP

Prenos TailwindCSS 4.x v PHP. CSS za pomožne razrede Tailwind ustvarjajte v PHP, brez Node.js in brez koraka gradnje. Vključuje cn(), tailwind-merge, CVA, vtičnika za tipografijo in obrazce ter CLI.

Terminal
composer require tailwindphp/tailwindphp

Najnovejša izdaja v1.7.0 MIT PHP 8.2+

V praksi

Podajte označevalno kodo in izbirni vhodni CSS v enem samem klicu PHP ter prejmite slogovno datoteko.

Ustvarite CSS iz PHP

tw::generate() pregleda označevalno kodo za imena razredov in vrne samo CSS, ki jih ti razredi potrebujejo. Drugi argument sprejme vhodni CSS, zato barva, določena v @theme, postane pripomoček.

cn() sestavlja nize razredov in razrešuje spore med Tailwind, zato zmaga zadnji nasprotujoči si pripomoček.

PHP
use TailwindPHP\tw;

$css = tw::generate(
    '<div class="bg-brand p-4">Hello</div>',
    '@import "tailwindcss"; @theme { --color-brand: #3b82f6; }'
);
// .bg-brand now resolves to var(--color-brand)

Čisto PHP

Brez Node.js in koraka gradnje. Deluje z PHP 8.2+ ter standardnima razširitvama mbstring in ctype. Namestite z ukazom composer require in začnite.

Sledi TailwindCSS v4.3.3

Prenos Tailwind v4.3.3 z istimi pripomočki, različicami in direktivami. Znane razlike glede na Tailwind so dokumentirane.

Več kot 4,400 testov

Izhod se preverja glede na lastne testne zbirke sistema TailwindCSS; pridobljene so iz izvorne kode TypeScript in se znova zaženejo ob vsakem potisku.

Vsi pripomočki in različice

Celoten nabor pripomočkov in vse različice: hover, focus, odzivni slogi, temni način, poizvedbe vsebnika in poljubne vrednosti.

Direktive CSS

@import, @theme, @apply, @utility, @custom-variant, @layer, @plugin in @source se razčlenijo in razrešijo v PHP.

Ustvarjanje med izvajanjem

sproti ustvarite pripomočke CSS iz HTML, vsebine zbirke podatkov ali spremenljivk predlog. Korak gradnje ni potreben.

Vse vključeno

cn(), merge(), join() in variants(): clsx, tailwind-merge in prenos CVA v PHP brez dodatnih paketov.

Vtičniki

Prenos @tailwindcss/typography in @tailwindcss/forms v PHP ter vtičnik PHPAPI za lastne pripomočke in komponente.

CLI

bin/tailwindphp iz vhodne datoteke CSS z možnostmi -i, -o, --watch in --minify ustvari slogovno datoteko.

Pregled teme

Vrednosti surovih in izračunanih lastnosti, barve, mejne točke in razmake za kateri koli razred preberite neposredno iz PHP.

Predpomnilnik in pomanjševalnik

Vgrajeni pomanjševalnik CSS in datotečni predpomnilnik s TTL poskrbita za hitrejše ponovne gradnje in manjši izhod.

Ogrodja WordPress in PHP

Uporabljajte teme in vtičnike na osnovi Tailwind brez Node.js v skladu. TailwindPHP je ena sama odvisnost Composer.

Zakaj TailwindPHP

Eno okolje izvajanja v produkciji

Projekt PHP, ki uvede Tailwind, običajno uvede tudi Node.js, namestitev npm ter korak gradnje v CI in Docker. Namesto tega TailwindPHP prevede CSS znotraj procesa PHP.

CSS za vsebino, znano med izvajanjem

Označevalna koda iz zbirke podatkov, uporabniški vnos ali spremenljivka predloge gre lahko neposredno v tw::generate(), ki vrne samo CSS, potrebne za njene razrede.

Preverjeno glede na določeno izdajo Tailwind

Testni primeri so izluščeni iz izvorne kode Tailwind, določene v repozitoriju, in izvedeni glede na izhod PHP, zato odstopanja povzročijo napako v CI. Izdaja 1.7.0 je bila preverjena glede na Tailwind v4.3.3 testov s 4,427.

CSS za vsako stran iz enega prevajalnika

Temo enkrat prevedite z tw::compile(), nato pa za vsako stran pokličite generateExact(). Vsak klic vrne to, kar bi ustvaril hladen tw::generate() te strani, brez ponovnega razčlenjevanja teme.

V primerjavi z

Tailwind Labs ponuja lastne načine za gradnjo Tailwind CSS. Tako se razlikuje TailwindPHP.

TailwindPHP v primerjavi z drugimi orodji
Tailwind CLI (@tailwindcss/cli) Primerno zaLastno orodje Tailwind za ukazno vrstico, nameščeno iz npm. Pregleda vaše datoteke HTML, komponente in predloge ter išče imena razredov, nato pa ustrezne sloge zapiše v statično datoteko CSS. Razlika v primerjavi z TailwindPHPTailwindPHP prevaja znotraj PHP brez namestitve Node.js ali npm. Sledi določeni izdaji Tailwind (v4.3.3 v 1.7.0), lastno merilo zmogljivosti pa kaže, da izvirnik TypeScript hitreje izvaja nizkonivojske operacije.
Samostojni Tailwind CLI Primerno zaTailwind CLI kot samostojna izvedljiva datoteka za projekte, ki jo želijo uporabljati brez namestitve Node.js. Razlika v primerjavi z TailwindPHPIzvedljiva datoteka je ločena binarna datoteka, ki se zažene kot korak gradnje. TailwindPHP je paket Composer, ki ga kliče vaša koda PHP, zato lahko med zahtevo ustvarja tudi CSS iz vsebine zbirke podatkov ali spremenljivk predlog.
Tailwind Play CDN Primerno zaOznaka script v brskalniku za zagon Tailwind, da ga preizkusite brez koraka gradnje. Dokumentacija za Tailwind navaja, da je namenjen razvoju in ni predviden za produkcijo. Razlika v primerjavi z TailwindPHPTailwindPHP prav tako ne potrebuje koraka gradnje, vendar na strežniku v PHP ustvari CSS in ga vrne kot niz, na primer za zapis v slogovno datoteko.

Vprašanja in odgovori

Kratki odgovori iz dokumentacije za TailwindPHP.

Namestite paket z Composer in sledite vodniku za prve korake, da ustvarite svojo prvo slogovno datoteko iz PHP.