CLI

./vendor/bin/tailwindphp yra PHP @tailwindcss/cli prievadas, kuriam nereikia Node.js. Jis naudoja tas pačias kūrimo parinktis, išskyrus šaltinio žemėlapius (--map), tačiau turinį nuskaito kitaip: žr. Ką nuskaito CLI. Po composer require tailwindphp/tailwindphp dvejetainis failas susiejamas su vendor/bin/.

Jei vykdymo metu iš PHP reikia tik CSS, naudokite API — CLI skirta kūrimo darbo eigoms, kurios įrašo stilių lentelę į diską.

Greita pradžia

# 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

Parinktys

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

Ilgųjų parinkčių reikšmę nurodykite su =: --input=./src/app.css, --output=./dist/styles.css, --cwd=/path/to/project. Tarpas ir reikšmė po ilgosios parinkties (--input ./src/app.css) šiuo metu ignoruojami be klaidos, o kūrimas naudoja numatytąsias reikšmes (#13). Trumposios parinktys reikšmę priima kaip kitą argumentą (-i ./src/app.css).

Kai --output yra - (numatytoji reikšmė), sukompiliuotas CSS išvedamas į stdout, todėl galite jį perduoti toliau. Eigos pranešimai (versijos antraštė ir Done in …ms) siunčiami į stderr.

Skirtingai nei @tailwindcss/cli, parinkties --map nėra: TailwindPHP šaltinio žemėlapių negeneruoja.

Įvesties CSS

Sukurkite app.css su Tailwind importu, tema ir direktyvomis:

@import "tailwindcss";

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

Ką nuskaito CLI

Turinio nuskaitymas CLI dar nepaiso @source taip, kaip tai daro @tailwindcss/cli (#8). Dabartinėje versijoje:

• Jei įvesties CSS faile nėra @source failo direktyvos, CLI rekursyviai nuskaito darbinį katalogą (--cwd). Tai apima vendor/ ir node_modules/; į .gitignore neatsižvelgiama.
• Jei yra viena ar daugiau @source failo direktyvų, CLI rekursyviai nuskaito įvesties failo katalogą. Direktyvoje nurodytas kelias arba glob šablonas netaikomas: @source "../templates" šalia src/app.css nuskaito src/, o ne templates/.
• @source not "…" direktyvos praleidžiamos; jos nieko nepašalina.
• @source inline("…") ir @source not inline("…") veikia, kaip aprašyta, nes jas apdoroja pats kompiliatorius.

Skaitomi tik šių plėtinių failai: php, html, htm, twig, blade.php, vue, jsx, tsx, svelte, astro ir mdx. Klasių pavadinimai imami iš atributų class ir className, kaip ir tw::extractCandidates(), todėl klasė, nurodyta tik eilutėje PHP arba JavaScript, neaptinkama. Tokias klases įtraukite naudodami @source inline("…").

Kol tai bus ištaisyta, patikimiausia įvesties CSS failą įdėti į skenuojamo katalogo šakninį lygį:

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

Direktyvų sintaksę, įskaitant formas not ir inline(), rasite čia: @source.

Pavyzdžiai

# 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 sukuria išvesties katalogą, jei jo nėra, ir pateikia klaidą, jei trūksta įvesties failo arba įvesties ir išvesties keliai sutampa. Stebėjimo režimu įvesties failas ir skenuojami failai tikrinami kas 500 ms; aptikus pakeitimą arba naują failą, kuriama iš naujo.

Visuotinis diegimas

Įdiekite globaliai, kad galėtumėte naudoti tailwindphp iš bet kur:

composer global require tailwindphp/tailwindphp

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

Dėl projekto sąrankos žr. Pradžia, o vykdymo aplinkos CSS generavimą iš PHP – API.