CLI

./vendor/bin/tailwindphp este o portare PHP a @tailwindcss/cli care nu necesită Node.js. Acceptă aceleași opțiuni de construire, cu excepția hărților sursă (--map), dar scanează conținutul diferit: consultați Ce scanează CLI. După composer require tailwindphp/tailwindphp, executabilul este legat în vendor/bin/.

Dacă aveți nevoie doar de CSS în timpul rulării din PHP, folosiți în schimb API — CLI este destinat fluxurilor de lucru din etapa de construire, care scriu o foaie de stiluri pe disc.

Pornire rapidă

# 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

Opțiuni

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

Specificați valorile opțiunilor lungi folosind =: --input=./src/app.css, --output=./dist/styles.css, --cwd=/path/to/project. O valoare separată prin spațiu după o opțiune lungă (--input ./src/app.css) este ignorată momentan fără eroare, iar compilarea folosește valorile implicite (#13). Opțiunile scurte preiau valoarea din argumentul următor (-i ./src/app.css).

Când --output este - (valoarea implicită), CSS compilat este scris la ieșirea standard, astfel încât îl puteți redirecționa în altă parte. Mesajele de progres (bannerul versiunii și Done in …ms) sunt trimise la ieșirea de eroare standard.

Spre deosebire de @tailwindcss/cli, nu există o opțiune --map: TailwindPHP nu generează hărți sursă.

Intrare CSS

Creați un app.css cu importul Tailwind, tema și directivele:

@import "tailwindcss";

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

Ce scanează CLI

Scanarea conținutului în CLI nu urmează încă @source așa cum o face @tailwindcss/cli (#8). În versiunea actuală:

• Fără o directivă de fișier @source în intrarea CSS, CLI scanează recursiv directorul de lucru (--cwd). Sunt incluse și vendor/ și node_modules/; .gitignore nu este consultat.
• Cu una sau mai multe directive de fișier @source, CLI scanează recursiv directorul fișierului de intrare. Calea sau globul din directivă nu se aplică: @source "../templates" aflat lângă src/app.css scanează src/, nu templates/.
• Directivele @source not "…" sunt ignorate; nu exclud nimic.
• @source inline("…") și @source not inline("…") funcționează conform documentației, deoarece compilatorul le gestionează direct.

Sunt citite doar fișierele cu aceste extensii: php, html, htm, twig, blade.php, vue, jsx, tsx, svelte, astro și mdx. Numele claselor sunt preluate din atributele class și className, la fel ca în tw::extractCandidates(), astfel că o clasă care apare doar într-un șir PHP sau JavaScript nu este găsită. Includeți explicit aceste clase cu @source inline("…").

Până la remedierea problemei, configurația fiabilă folosește un fișier de intrare CSS în directorul de sus pe care doriți să-l scanați:

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

Consultați @source pentru sintaxa directivelor, inclusiv formele not și inline().

Exemple

# 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 creează directorul de ieșire dacă acesta nu există și se închide cu o eroare dacă lipsește fișierul de intrare sau dacă aceleași căi sunt folosite pentru intrare și ieșire. Modul de urmărire verifică fișierul de intrare și fișierele scanate la fiecare 500 ms și reconstruiește rezultatul când unul dintre ele se modifică sau apare un fișier nou.

Instalare globală

Instalați global pentru a folosi tailwindphp de oriunde:

composer global require tailwindphp/tailwindphp

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

Consultați Getting Started pentru configurarea proiectului și API pentru generarea în timpul execuției a CSS din PHP.