CLI

./vendor/bin/tailwindphp je PHP port @tailwindcss/cli bez potreby Node.js. Používa rovnaké možnosti zostavenia okrem zdrojových máp (--map), obsah však skenuje inak: pozrite si Čo CLI skenuje. Po composer require tailwindphp/tailwindphp sa binárny súbor prepojí do vendor/bin/.

Ak pri behu potrebujete z PHP iba CSS, použite namiesto toho API — CLI je určený na pracovné postupy zostavovania, ktoré zapisujú štýlový hárok na disk.

Rýchly začiatok

# Build CSS from an input file
./vendor/bin/tailwindphp -i ./src/app.css -o ./dist/styles.css

# Watch for changes and rebuild
./vendor/bin/tailwindphp -i ./src/app.css -o ./dist/styles.css --watch

# Build minified for production
./vendor/bin/tailwindphp -i ./src/app.css -o ./dist/styles.css --minify

Možnosti

tailwindphp [-i input.css] [-o output.css] [--watch] [options…]

Dlhým možnostiam zadajte hodnotu pomocou =: --input=./src/app.css, --output=./dist/styles.css, --cwd=/path/to/project. Hodnota oddelená medzerou za dlhou možnosťou (--input ./src/app.css) sa v súčasnosti bez chyby ignoruje a zostavenie použije predvolené hodnoty (#13). Krátke možnosti prijímajú hodnotu ako nasledujúci argument (-i ./src/app.css).

Keď je --output nastavené na - (predvolená hodnota), skompilované CSS sa vypíše na štandardný výstup, takže ho môžete presmerovať ďalej. Správy o priebehu (banner s verziou a Done in …ms) sa vypisujú na štandardný chybový výstup.

Na rozdiel od @tailwindcss/cli tu nie je možnosť --map: TailwindPHP nevytvára zdrojové mapy.

Vstup CSS

Vytvorte app.css pomocou importu Tailwind, témy a direktív:

@import "tailwindcss";

@theme {
    --color-brand: #3b82f6;
}

Čo skenuje CLI

Skenovanie obsahu v CLI zatiaľ nenasleduje @source tak, ako to robí @tailwindcss/cli (#8). V aktuálnom vydaní:

• Bez direktívy súboru @source vo vstupnom CSS skenuje CLI rekurzívne pracovný adresár (--cwd). Zahŕňa to aj vendor/ a node_modules/; .gitignore sa nekontroluje.
• S jednou alebo viacerými direktívami súboru @source skenuje CLI rekurzívne adresár vstupného súboru. Cesta ani globovací vzor v direktíve sa nepoužijú: @source "../templates" vedľa src/app.css skenuje src/, nie templates/.
• Direktívy @source not "…" sa preskočia; nič nevylučujú.
• Direktívy @source inline("…") a @source not inline("…") fungujú podľa dokumentácie, pretože ich spracúva samotný kompilátor.

Čítajú sa iba súbory s týmito príponami: php, html, htm, twig, blade.php, vue, jsx, tsx, svelte, astro a mdx. Názvy tried sa získavajú z atribútov class a className, rovnako ako v tw::extractCandidates(), takže trieda, ktorá sa nachádza iba v reťazci PHP alebo JavaScript, sa nenájde. Takéto triedy môžete vynútiť pomocou @source inline("…").

Kým sa to neopraví, spoľahlivým riešením je umiestniť vstupný súbor CSS na začiatok adresára, ktorý chcete skenovať:

/* templates/app.css: scans templates/ recursively */
@import "tailwindcss";
@source "./";

Syntax direktívy vrátane foriem not a inline() nájdete v časti @source.

Príklady

# Build from an input file
tailwindphp -i ./src/app.css -o ./dist/styles.css

# Build minified for production
tailwindphp -i ./src/app.css -o ./dist/styles.css -m

# Watch mode with minification
tailwindphp -i ./src/app.css -o ./dist/styles.css -w -m

# Run against a different working directory
tailwindphp -i app.css -o dist/styles.css --cwd=/path/to/project

CLI vytvorí výstupný adresár, ak neexistuje, a skončí s chybou, ak chýba vstupný súbor alebo sú cesty vstupu a výstupu totožné. Režim sledovania kontroluje vstupný súbor a skenované súbory každých 500 ms a znova zostaví výstup, keď sa niektorý zmení alebo sa objaví nový súbor.

Globálna inštalácia

Nainštalujte globálne a používajte tailwindphp odkiaľkoľvek:

composer global require tailwindphp/tailwindphp

# Now available globally
tailwindphp -i ./src/app.css -o ./dist/styles.css

Nastavenie projektu nájdete v časti Začíname a generovanie CSS za behu z PHP v časti API.