Preskočiť na obsah

TailwindPHP

Zobraziť ako Markdown Upraviť na GitHub Dokumentácia na 3843abd

TailwindPHP je 1:1 port jazyka TailwindCSS 4.x do PHP. Parsuje CSS, skenuje značkovanie a hľadá názvy tried, potom generuje pomocné CSS, ktoré vytvára TailwindCSS v4.3.3 — celé v PHP, bez Node.js a kroku zostavenia.

  • Čisté PHP — dodáva sa ako balík Composer a funguje na PHP 8.2+ so štandardnými rozšíreniami ctype a mbstring. Bez exec, FFI a natívnych nástrojov na zostavovanie.
  • Overené oproti TailwindCSS — nástroje, varianty, direktívy a funkcie CSS zodpovedajú TailwindCSS v4.3.3. Výstup sa overuje pomocou vlastných testovacích sád Tailwind, extrahovaných zo zdrojového kódu TypeScript a spúšťaných pri každom odoslaní zmien (4,400+ testov). Známe rozdiely (niekoľko detailov serializácie bez vplyvu na kaskádu a otvorené problémy) sú uvedené v časti Kompatibilita a aktualizácia.
  • Celá sada funkcií — úplná sada nástrojov TailwindCSS v4.3.3 (vrátane container, nástrojov pre posuvníky, zoom-* a tab-*), všetky varianty (hover, focus, responzívne zobrazenie, tmavý režim, kontajnerové dotazy, ľubovoľné hodnoty) a úplné rozhranie direktív: @import, @theme, @apply, @utility, @variant, @custom-variant, @layer, @plugin a @source.
  • Všetko potrebné v balíku — cn(), merge(), join() a variants() obsahujú porty PHP knižníc clsx, tailwind-merge a CVA, takže sprievodné knižnice, po ktorých siahne každý projekt Tailwind, už máte k dispozícii.
  • Pluginy — @tailwindcss/typography a @tailwindcss/forms sú prenesené v plnom rozsahu a PHP plugin API vám umožňuje vytvoriť si vlastný.

Prečo vzniklo TailwindPHP

TailwindCSS je napísané v TypeScript a beží na Node.js. To je tvrdá požiadavka pre každý projekt PHP, ktorý chce používať Tailwind: druhé prostredie na spúšťanie, inštaláciu npm a krok zostavenia v CI aj Docker. Pre mnohé aplikácie PHP je to zbytočná záťaž.

TailwindPHP túto prekážku odstraňuje. Váš kód PHP sa kompiluje priamo do Tailwind CSS, pričom používa iba štandardnú knižnicu. Vďaka tomu sú možné veci, ktoré sa s nástrojmi JavaScript robia ťažko alebo vôbec:

  • Frameworky WordPress a PHP — dodávajte témy a pluginy poháňané Tailwind bez toho, aby používatelia museli inštalovať Node.js alebo spúšťať zostavenie. Stačí composer require a môžete začať. Pozrite si TailwindWP, ukážkový plugin WordPress, ktorý generuje CSS editora blokov pomocou TailwindPHP.
  • CSS za behu — generujte pomocné CSS priebežne z používateľského vstupu, obsahu databázy alebo premenných šablóny namiesto generovania pri zostavení.
  • Jednoduchšie nasadenie — v produkcii netreba Node.js, krok zostavenia v CI ani npm v obraze Docker.

Je to rovnaká myšlienka, akú scssphp priniesol do SCSS — celý kompilátor v PHP.

Čo dokáže

  • Kompiluje sadu nástrojov TailwindCSS v4.3.3, varianty a ľubovoľné hodnoty z názvov tried nájdených v obsahu.
  • Spracúva celé rozhranie direktív: @import (vrátane virtuálnych modulov ako tailwindcss a tailwindcss/utilities a importov reference), @theme, @apply, @utility, @variant, @custom-variant, @layer, @plugin a @source.
  • Implementuje funkcie CSS Tailwind — theme(), --theme(), --spacing() a --alpha() — a tiež konverziu color-mix() → oklab() a transformácie CSS, ktoré TailwindCSS deleguje na LightningCSS.
  • Načítava @import zo súborového systému s vnorenými importmi, deduplikáciou a vlastnými resolvermi alebo z vložených reťazcov CSS.
  • Obsahuje Preflight (základný reset Tailwind), podporu prefixov, náhradné hodnoty @property, pridávanie prefixov dodávateľov a presúvanie kľúčových snímok.
  • Obsahuje cn(), merge(), join() a variants()/compose() na tvorbu názvov tried, riešenie konfliktov a varianty komponentov.
  • Zahŕňa pluginy pre typografiu a formuláre a rozhranie pluginu API (addUtilities, matchUtilities, addComponents, addVariant, theme, …) na tvorbu vlastných pluginov.
  • Poskytuje CLI (bin/tailwindphp) s možnosťami zostavenia @tailwindcss/cli, ukladanie výstupu zo súborov a trvalého stavu kompilátora do vyrovnávacej pamäte a minimalizátor CSS pre produkčné nasadenie.

Čo to nie je

TailwindPHP je kompilátor CSS, nie sada nástrojov pre editor. Zámerne vynecháva súčasti ekosystému Tailwind určené pre IDE — IntelliSense, automatické dopĺňanie, zoradenie tried a zdrojové mapy — pretože ide o funkcie editora, nie o súčasť generovania CSS. Patrí sem všetko, čo vytvára CSS; všetko, čo poháňa váš editor, sem nepatrí.

Kde začať

  • Začíname — nainštalujte balík a vytvorte svoj prvý štýlový hárok.
  • Použitie — skenujte obsah, prispôsobte tému a používajte direktívy Tailwind.
  • Pomocné triedy — cn(), merge(), join() a variants().
  • Pluginy — typografia, formuláre a tvorba vlastných pluginov.
  • API — úplné rozhranie tw a inštancia TailwindCompiler.
  • CLI — bin/tailwindphp na zostavovanie zo súborov a sledovanie zmien.
  • Pokročilé témy — architektúra, ukladanie do vyrovnávacej pamäte, výkon a poznámky ku kompatibilite.