CLI

./vendor/bin/tailwindphp, @tailwindcss/cli'ın PHP uyarlamasıdır ve Node.js gerektirmez. Kaynak eşlemeleri (--map) dışında aynı derleme seçeneklerini alır; ancak içeriği farklı tarar: bkz. What the CLI scans. composer require tailwindphp/tailwindphp sonrasında ikili dosya vendor/bin/ içine bağlanır.

Çalışma zamanında PHP içinden yalnızca CSS gerekiyorsa, bunun yerine API kullanın; CLI, stil sayfasını diske yazan derleme adımı iş akışları içindir.

Hızlı başlangıç

# 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

Seçenekler

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

Uzun seçeneklere değerlerini = ile verin: --input=./src/app.css, --output=./dist/styles.css, --cwd=/path/to/project. Uzun bir seçeneğin ardından boşlukla ayrılmış değer (--input ./src/app.css) şu anda hata vermeden yok sayılır ve derleme varsayılanlara (#13) döner. Kısa seçeneklerde değer sonraki bağımsız değişken olarak verilir (-i ./src/app.css).

--output - olduğunda (varsayılan), derlenen CSS stdout'a yazılır; böylece çıktıyı başka bir yere aktarabilirsiniz. Sürüm bandı ve Done in …ms gibi ilerleme iletileri stderr'e gider.

@tailwindcss/cli'den farklı olarak --map seçeneği yoktur: TailwindPHP kaynak eşlemeleri oluşturmaz.

Girdi CSS

Tailwind içe aktarmanız, temanız ve yönergelerinizle bir app.css oluşturun:

@import "tailwindcss";

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

CLI neleri tarar

CLI içindeki içerik taraması henüz @tailwindcss/cli gibi @source yönergesini izlemez (#8). Mevcut sürümde:

• Girdi CSS içinde @source dosya yönergesi yoksa, CLI çalışma dizinini (--cwd) özyinelemeli olarak tarar. Buna vendor/ ve node_modules/ dahildir; .gitignore dikkate alınmaz.
• Bir veya daha fazla @source dosya yönergesi varsa, CLI girdi dosyasının bulunduğu dizini özyinelemeli olarak tarar. Yönergedeki yol veya glob uygulanmaz: src/app.css yanındaki @source "../templates", src/ dizinini tarar; templates/ dizinini değil.
• @source not "…" yönergeleri atlanır; hiçbir şeyi dışlamazlar.
• @source inline("…") ve @source not inline("…") belgelerde anlatıldığı gibi çalışır; çünkü bunları derleyici kendisi işler.

Yalnızca şu uzantılara sahip dosyalar okunur: php, html, htm, twig, blade.php, vue, jsx, tsx, svelte, astro ve mdx. Sınıf adları, tw::extractCandidates() ile aynı şekilde class ve className özniteliklerinden alınır; bu nedenle yalnızca bir PHP veya JavaScript dizgesinde görünen sınıflar bulunmaz. Bu tür sınıfları @source inline("…") ile zorla ekleyin.

Bu düzeltilene kadar güvenilir kurulum, taranmasını istediğiniz dizinin en üstüne bir girdi CSS dosyası koymaktır:

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

Sözdizimi için @source bölümüne, not ve inline() biçimleri dahil, bakın.

Örnekler

# 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, yoksa çıktı dizinini oluşturur; girdi dosyası eksikse veya girdi ve çıktı yolları aynıysa hata vererek çıkar. İzleme modu, girdi dosyasını ve taranan dosyaları her 500 ms'de bir yoklar; bunlardan biri değiştiğinde veya yeni bir dosya belirdiğinde yeniden derler.

Genel kurulum

tailwindphp komutunu her yerden kullanmak için genel olarak yükleyin:

composer global require tailwindphp/tailwindphp

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

Proje kurulumu için Başlarken bölümüne, PHP üzerinden çalışma zamanı CSS oluşturma için de API bölümüne bakın.