CLI

./vendor/bin/tailwindphp er en PHP portering af @tailwindcss/cli uden krav om Node.js. Den bruger de samme buildindstillinger bortset fra source maps (--map), men scanner indhold anderledes: se Hvad CLI scanner. Efter composer require tailwindphp/tailwindphp linkes binærfilen ind i vendor/bin/.

Hvis du kun har brug for CSS under kørsel fra PHP, skal du i stedet bruge API — CLI er til build-workflows, der skriver et stylesheet til disk.

Hurtig start

# 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

Indstillinger

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

Angiv værdien for lange indstillinger med =: --input=./src/app.css, --output=./dist/styles.css, --cwd=/path/to/project. En mellemrumssepareret værdi efter en lang indstilling (--input ./src/app.css) ignoreres i øjeblikket uden fejl, og buildet bruger standardværdierne (#13). Korte indstillinger tager værdien som det næste argument (-i ./src/app.css).

Når --output er - (standardværdien), skrives det kompilerede CSS til stdout, så du kan sende det videre med en pipe. Statusmeddelelser (versionsbanneret og Done in …ms) sendes til stderr.

I modsætning til @tailwindcss/cli findes der ingen --map-indstilling: TailwindPHP genererer ikke source maps.

Input CSS

Opret en app.css med din Tailwind-import, dit tema og dine direktiver:

@import "tailwindcss";

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

Hvad CLI scanner

Indholdsscanning i CLI følger endnu ikke @source på samme måde som @tailwindcss/cli gør (#8). I den aktuelle udgivelse gælder følgende:

• Uden et @source-fildirektiv i inputfilen CSS scanner CLI arbejdsbiblioteket (--cwd) rekursivt. Det omfatter vendor/ og node_modules/; .gitignore tjekkes ikke.
• Med et eller flere @source-fildirektiver scanner CLI inputfilens bibliotek rekursivt. Stien eller globmønstret i direktivet anvendes ikke: @source "../templates" ved siden af src/app.css scanner src/, ikke templates/.
• @source not "…"-direktiver springes over; de udelukker intet.
• @source inline("…") og @source not inline("…") fungerer som dokumenteret, fordi compileren håndterer dem selv.

Der læses kun filer med disse filendelser: php, html, htm, twig, blade.php, vue, jsx, tsx, svelte, astro og mdx. Klassenavne hentes fra attributterne class og className, ligesom i tw::extractCandidates(), så en klasse, der kun forekommer i en PHP- eller JavaScript-streng, ikke findes. Medtag sådanne klasser med @source inline("…").

Indtil det er rettet, er den pålidelige opsætning en inputfil CSS øverst i det bibliotek, du vil scanne:

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

Se @source for direktivsyntaksen, herunder formerne not og inline().

Eksempler

# 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 opretter outputbiblioteket, hvis det ikke findes, og afsluttes med en fejl, hvis inputfilen mangler, eller input- og outputstierne er identiske. Overvågningstilstand kontrollerer inputfilen og de scannede filer hvert 500 ms og bygger igen, når en af dem ændres, eller en ny fil dukker op.

Global installation

Installer globalt for at bruge tailwindphp fra enhver placering:

composer global require tailwindphp/tailwindphp

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

Se Kom godt i gang for projektopsætning og API for generering af CSS under kørsel fra PHP.