CLI

./vendor/bin/tailwindphp on PHP-porttaus ohjelmasta @tailwindcss/cli, eikä Node.js-vaatimusta ole. Se käyttää samoja build-asetuksia lähdekarttoja (--map) lukuun ottamatta, mutta sisällön skannaus toimii eri tavalla: katso Mitä CLI skannaa. composer require tailwindphp/tailwindphp-vaiheen jälkeen binääri linkitetään osaksi vendor/bin/-tiedostoa.

Jos tarvitset ajonaikana vain CSS-toiminnon paketista PHP, käytä sen sijaan API-pakettia — CLI on tarkoitettu build-vaiheen työnkulkuihin, joissa tyylitiedosto kirjoitetaan levylle.

Pika-aloitus

# 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

Asetukset

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

Anna pitkille valitsimille arvo muodossa =: --input=./src/app.css, --output=./dist/styles.css, --cwd=/path/to/project. Pitkän valitsimen jälkeen välilyönnillä erotettu arvo (--input ./src/app.css) ohitetaan tällä hetkellä virheettä, ja build käyttää oletusarvoja (#13). Lyhyet valitsimet saavat arvon seuraavana argumenttina (-i ./src/app.css).

Kun --output on - (oletusarvo), käännetty CSS kirjoitetaan stdout-virtaan, joten voit ohjata sen putkella muualle. Edistymisviestit (versiobanneri ja Done in …ms) kirjoitetaan stderr-virtaan.

Toisin kuin @tailwindcss/cli-komennossa, --map-valitsinta ei ole: TailwindPHP ei luo lähdekarttoja.

Syöte-CSS

Luo app.css, jossa on Tailwind-tuonti, teema ja direktiivit:

@import "tailwindcss";

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

Mitä CLI skannaa

CLI-komennon sisällön skannaus ei vielä noudata @source-määritystä samalla tavalla kuin @tailwindcss/cli tekee (#8). Nykyisessä julkaisussa:

• Jos syöte-CSS-tiedostossa ei ole @source-direktiiviä, CLI skannaa työhakemiston (--cwd) rekursiivisesti. Mukaan otetaan myös vendor/ ja node_modules/; .gitignore-asetusta ei tarkisteta.
• Jos tiedostossa on vähintään yksi @source-direktiivi, CLI skannaa rekursiivisesti syötetiedoston hakemiston. Direktiivin polkua tai glob-kuviota ei käytetä: src/app.css-tiedoston vieressä oleva @source "../templates" skannaa src/-hakemiston, ei templates/-hakemistoa.
• @source not "…"-direktiivit ohitetaan; ne eivät sulje mitään pois.
• @source inline("…")- ja @source not inline("…")-direktiivit toimivat dokumentaation mukaisesti, koska kääntäjä käsittelee ne itse.

Vain näillä tiedostopäätteillä varustetut tiedostot luetaan: php, html, htm, twig, blade.php, vue, jsx, tsx, svelte, astro ja mdx. Luokkien nimet poimitaan class- ja className-attribuuteista samalla tavalla kuin tw::extractCandidates()-toiminnossa, joten pelkästään PHP- tai JavaScript-merkkijonossa esiintyvä luokka jää löytymättä. Lisää tällaiset luokat pakolla käyttämällä @source inline("…")-direktiiviä.

Kunnes ongelma on korjattu, luotettava ratkaisu on sijoittaa syöte-CSS-tiedosto skannattavan hakemiston ylimmälle tasolle:

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

Katso @source-direktiivin syntaksi, mukaan lukien not- ja inline()-muodot.

Esimerkkejä

# 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 luo tuloshakemiston, jos sitä ei ole, ja päättyy virheeseen, jos syötetiedosto puuttuu tai syöte- ja tulostuspolut ovat samat. Tarkkailutila tarkistaa syötetiedoston ja skannatut tiedostot 500 ms välein ja rakentaa uudelleen, jos jokin niistä muuttuu tai uusi tiedosto ilmestyy.

Asennus globaalisti

Asenna globaalisti, jotta voit käyttää tailwindphp-komentoa mistä tahansa:

composer global require tailwindphp/tailwindphp

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

Katso Aloitusopas projektin käyttöönottoa varten ja API ajonaikaista CSS-muodostusta varten paketista PHP.