CLI

A ./vendor/bin/tailwindphp a @tailwindcss/cli PHP portja, amelyhez nem szükséges Node.js. Ugyanazokat az összeállítási beállításokat fogadja, a forrástérképek kivételével (--map), de másképp vizsgálja át a tartalmat: lásd: Mit vizsgál át a CLI. A composer require tailwindphp/tailwindphp után a bináris állomány a vendor/bin/ részévé válik.

Ha futásidőben csak CSS kell a(z) PHP alkalmazásból, használja inkább a API megoldást — a CLI olyan összeállítási munkafolyamatokhoz való, amelyek lemezre írnak stíluslapot.

Gyors kezdés

# 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

Beállítások

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

A hosszú kapcsolók értékét a = jellel adja meg: --input=./src/app.css, --output=./dist/styles.css, --cwd=/path/to/project. A hosszú kapcsoló utáni szóközzel elválasztott értéket (--input ./src/app.css) a rendszer jelenleg hiba nélkül figyelmen kívül hagyja, az összeállítás pedig az alapértelmezésekkel folytatódik (#13). A rövid kapcsolóknál az értéket következő argumentumként kell megadni (-i ./src/app.css).

Ha a --output értéke - (az alapértelmezett), a lefordított CSS a szabványos kimenetre kerül, így továbbíthatja egy másik parancsnak. Az állapotüzenetek (a verziószámot tartalmazó fejléc és a Done in …ms) a szabványos hibakimenetre kerülnek.

A @tailwindcss/cli megoldással ellentétben itt nincs --map kapcsoló: a TailwindPHP nem készít forrástérképeket.

Bemeneti CSS

Hozzon létre egy app.css fájlt a Tailwind importtal, témával és direktívákkal:

@import "tailwindcss";

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

Mit vizsgál át a CLI

A CLI tartalomvizsgálata még nem követi a @source működését úgy, ahogy a @tailwindcss/cli teszi (#8). A jelenlegi kiadásban:

• Ha a bemeneti CSS fájl nem tartalmaz @source direktívát, a CLI rekurzívan átvizsgálja a munkakönyvtárat (--cwd). Ez a vendor/ és a node_modules/ tartalmát is magában foglalja; a .gitignore értékét nem veszi figyelembe.
• Ha egy vagy több @source fájldirektíva szerepel, a CLI rekurzívan átvizsgálja a bemeneti fájl könyvtárát. A direktívában szereplő útvonalat vagy glob mintát nem alkalmazza: a @source "../templates" és a src/app.css egymás mellé helyezve a src/ tartalmát vizsgálja, nem a templates/ tartalmát.
• A @source not "…" direktívákat kihagyja, így azok nem zárnak ki semmit.
• A @source inline("…") és a @source not inline("…") dokumentált módon működik, mert ezeket maga a fordító kezeli.

Csak a következő kiterjesztésű fájlokat olvassa be: php, html, htm, twig, blade.php, vue, jsx, tsx, svelte, astro és mdx. Az osztályneveket a class és a className attribútumokból veszi, ugyanúgy, mint a tw::extractCandidates() esetében; ezért nem találja meg az olyan osztályt, amely csak egy PHP vagy JavaScript karakterláncban szerepel. Az ilyen osztályokat a @source inline("…") segítségével kényszerítheti bele.

A javításig megbízható megoldás, ha a beolvasandó könyvtár tetejére helyez egy bemeneti CSS fájlt:

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

A direktívák szintaxisáért lásd az @source oldalt, beleértve a not és inline() formákat.

Példák

# 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

A CLI létrehozza a kimeneti könyvtárat, ha az még nem létezik; hibával leáll, ha hiányzik a bemeneti fájl, vagy ha a bemeneti és kimeneti útvonal azonos. Figyelő módban 500 ms-onként ellenőrzi a bemeneti és az átvizsgált fájlokat, majd újraépít, ha valamelyik megváltozik, vagy új fájl jelenik meg.

Globális telepítés

Telepítse globálisan, hogy bárhonnan használhassa a tailwindphp parancsot:

composer global require tailwindphp/tailwindphp

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

A projekt beállításáért lásd az Első lépések oldalt, futásidejű CSS-generáláshoz pedig a API oldalt, PHP használatával.