CLI

./vendor/bin/tailwindphp on PHP teisendus @tailwindcss/cli-ist, mille kasutamiseks pole vaja Node.js-i. See kasutab samu koostamisvalikuid, välja arvatud lähtekaardid (--map), kuid skannib sisu teisiti: vaata Mida CLI skannib. Pärast composer require tailwindphp/tailwindphp-i lingitakse binaar vendor/bin/-iga.

Kui vajad käitusajal CSS-i ainult paketist PHP, kasuta selle asemel API; CLI on mõeldud koostamisetapi töövoogude jaoks, mis kirjutavad laaditabeli kettale.

Kiire alustamine

# 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

Suvandid

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

Anna pikkadele valikutele väärtus koos =-ga: --input=./src/app.css, --output=./dist/styles.css, --cwd=/path/to/project. Pika valiku järel tühikuga eraldatud väärtust (--input ./src/app.css) praegu veateateta eiratakse ning koostamisel kasutatakse vaikeväärtusi (#13). Lühikeste valikute väärtus tuleb järgmise argumendina (-i ./src/app.css).

Kui --output väärtus on - (vaikimisi), kirjutatakse kompileeritud CSS standardväljundisse, nii et saad selle edasi suunata. Edenemisteated (versioonibänner ja Done in …ms) väljastatakse standardveaväljundisse.

Erinevalt @tailwindcss/cli-st puudub valik --map: TailwindPHP ei loo lähtekaarte.

Sisend CSS

Loo app.css oma Tailwind impordi, teema ja käskudega:

@import "tailwindcss";

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

Mida CLI skannib

Paketi CLI sisuskannimine ei järgi veel @source-i nii nagu @tailwindcss/cli (#8). Praeguses väljalaskes kehtib järgmine:

• Kui sisendi CSS-failis pole @source-failidirektiivi, skannib CLI rekursiivselt töökataloogi (--cwd). See hõlmab ka vendor/ ja node_modules/; .gitignore-i ei kontrollita.
• Kui on üks või mitu @source-failidirektiivi, skannib CLI rekursiivselt sisendfaili kataloogi. Direktiivis olevat teed või glob-mustrit ei rakendata: @source "../templates" skannib src/app.css-i kõrval asuvana kataloogi src/, mitte templates/.
• @source not "…" direktiivid jäetakse vahele; need ei välista midagi.
• @source inline("…") ja @source not inline("…") töötavad dokumentatsiooni kohaselt, sest kompilaator käsitleb neid ise.

Loetakse ainult järgmiste laienditega faile: php, html, htm, twig, blade.php, vue, jsx, tsx, svelte, astro ja mdx. Klassinimed võetakse atribuutidest class ja className samamoodi nagu tw::extractCandidates() puhul, mistõttu ainult PHP- või JavaScript-stringis esinevat klassi ei leita. Lisa sellised klassid jõuga käsuga @source inline("…").

Kuni see on parandatud, töötab kõige kindlamalt sisend-CSS-fail, mis asub skannitava kataloogi tipus:

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

Süntaksi, sealhulgas not- ja inline()-vormide kohta vaata direktiivi @source.

Näited

# 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 loob väljundkataloogi, kui seda pole, ja annab vea, kui sisendfail puudub või sisendi- ja väljundteed on samad. Jälgimisrežiim kontrollib sisendfaili ja skannitud faile iga 500 ms järel ning koostab uuesti, kui mõni neist muutub või ilmub uus fail.

Globaalne paigaldus

Paigalda globaalselt, et kasutada tailwindphp-i kõikjal:

composer global require tailwindphp/tailwindphp

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

Vaata jaotist Alustamine projekti seadistamiseks ning juhendit API käitusaja CSS genereerimiseks paketist PHP.