CLI

./vendor/bin/tailwindphp je port PHP nástroje @tailwindcss/cli bez nutnosti Node.js. Používá stejné volby sestavení, s výjimkou zdrojových map (--map), ale obsah prohledává jinak: viz Co prohledává CLI. Po composer require tailwindphp/tailwindphp se binární soubor připojí k vendor/bin/.

Pokud za běhu potřebujete pouze CSS z PHP, použijte místo toho API — CLI slouží k sestavení, která zapisují šablonu stylů na disk.

Rychlý začátek

# 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…]

Dlouhým volbám předávejte hodnotu pomocí =: --input=./src/app.css, --output=./dist/styles.css, --cwd=/path/to/project. Hodnota oddělená mezerou za dlouhou volbou (--input ./src/app.css) se nyní bez chyby ignoruje a sestavení použije výchozí hodnoty (#13). Krátké volby přebírají hodnotu jako následující argument (-i ./src/app.css).

Když je --output nastaveno na - (výchozí hodnota), zkompilované CSS se vypíše na standardní výstup, takže ho můžete přesměrovat dál. Zprávy o průběhu (banner s verzí a Done in …ms) se vypisují na standardní chybový výstup.

Na rozdíl od @tailwindcss/cli nemá volbu --map: TailwindPHP negeneruje zdrojové mapy.

Vstup CSS

Vytvořte app.css pomocí importu Tailwind, motivu a direktiv:

@import "tailwindcss";

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

Co CLI prohledává

Prohledávání obsahu v CLI zatím nefunguje podle @source tak jako v @tailwindcss/cli (#8). V aktuálním vydání platí:

• Pokud vstupní CSS neobsahuje direktivu souboru @source, CLI rekurzivně prohledá pracovní adresář (--cwd). Zahrne také vendor/ a node_modules/; .gitignore se nepoužije.
• Pokud obsahuje jednu nebo více direktiv souboru @source, CLI rekurzivně prohledá adresář vstupního souboru. Cesta ani glob v direktivě se nepoužijí: @source "../templates" vedle src/app.css prohledá src/, nikoli templates/.
• Direktivy @source not "…" se přeskočí; nic nevylučují.
• Direktivy @source inline("…") a @source not inline("…") fungují podle dokumentace, protože je zpracovává přímo kompilátor.

Načítají se pouze soubory s těmito příponami: php, html, htm, twig, blade.php, vue, jsx, tsx, svelte, astro a mdx. Názvy tříd se přebírají z atributů class a className, stejně jako v tw::extractCandidates(), takže se nenajde třída uvedená pouze v řetězci PHP nebo JavaScript. Takové třídy přidejte ručně pomocí @source inline("…").

Než se to opraví, spolehlivým řešením je umístit vstupní soubor CSS do kořenového adresáře, který chcete prohledat:

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

Syntaxi direktivy včetně forem not a inline() najdete v části @source.

Pří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 vytvoří výstupní adresář, pokud neexistuje, a skončí s chybou, pokud chybí vstupní soubor nebo jsou cesty vstupu a výstupu totožné. Režim sledování kontroluje vstupní soubor a prohledávané soubory každých 500 ms a znovu sestaví výstup, když se některý změní nebo se objeví nový soubor.

Globální instalace

Nainstalujte tailwindphp globálně, abyste jej mohli používat odkudkoli:

composer global require tailwindphp/tailwindphp

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

Nastavení projektu najdete v části Začínáme a generování runtime CSS z PHP v části API.