TailwindPHP

TailwindPHP, 1:1 TailwindCSS 4.x'nin PHP için bir uyarlamasıdır. CSS dosyanızı ayrıştırır, biçimlendirmenizi sınıf adları için tarar ve TailwindCSS v4.3.3'in ürettiği yardımcı CSS öğelerini oluşturur — tümüyle PHP'te, Node.js olmadan ve derleme adımı gerektirmeden.

• Saf PHP — Composer paketi olarak dağıtılır ve standart ctype ile mbstring uzantılarıyla PHP 8.2+ üzerinde çalışır. exec, FFI veya yerel derleme araçları gerekmez.
• TailwindCSS ile doğrulanmıştır — yardımcılar, varyantlar, yönergeler ve CSS işlevleri TailwindCSS v4.3.3 sürümünü takip eder. Çıktı, TypeScript kaynak kodundan çıkarılıp her gönderimde yeniden çalıştırılan Tailwind test paketleriyle doğrulanır (4,400+ test). Bilinen farklar (basamaklı etkisi olmayan birkaç serileştirme ayrıntısı ve açık sorunlar) Uyumluluk ve yükseltme bölümünde listelenmiştir.
• Eksiksiz özellik kümesi — tüm TailwindCSS v4.3.3 yardımcı kümesi (container, kaydırma çubuğu yardımcıları, zoom-* ve tab-* dahil), tüm varyantlar (üzerine gelme, odak, duyarlı tasarım, koyu mod, kapsayıcı sorguları, keyfi değerler) ve yönergelerin tamamı: @import, @theme, @apply, @utility, @variant, @custom-variant, @layer, @plugin ve @source.
• Her şey dahil — cn(), merge(), join() ve variants(), clsx, tailwind-merge ve CVA'nın PHP bağlantı noktalarını içerir; böylece her Tailwind projesinin ihtiyaç duyduğu yardımcı kütüphaneler hazır gelir.
• Eklentiler — @tailwindcss/typography ve @tailwindcss/forms tamamen taşınmıştır; kendi eklentinizi yazmanız için PHP eklenti API de sunulur.

TailwindPHP neden var

TailwindCSS TypeScript ile yazılmıştır ve Node.js üzerinde çalışır. Tailwind isteyen her PHP projesi için bu kesin bir gereksinimdir: ikinci bir çalışma zamanı, bir npm kurulumu ve CI ile Docker içinde bir derleme adımı. Pek çok PHP uygulaması için bu, üstlenmek istemeyecekleri bir ek yüktür.

TailwindPHP bu gereksinimi ortadan kaldırır. PHP kodunuz yalnızca standart kütüphaneyi kullanarak doğrudan Tailwind CSS derlenir. Böylece JavaScript araç zinciriyle kullanımı zor veya imkânsız olan bazı olanakların önü açılır:

• WordPress ve PHP çerçeveleri — kullanıcılardan Node.js yüklemelerini veya derleme çalıştırmalarını istemeden Tailwind destekli temalar ve eklentiler dağıtın. Yalnızca composer require deyin ve kullanmaya başlayın. TailwindWP sayfasında, TailwindPHP ile blok düzenleyici CSS oluşturan örnek bir WordPress eklentisi görebilirsiniz.
• Çalışma zamanı CSS — derleme zamanında değil, kullanıcı girdilerinden, veritabanı içeriğinden veya şablon değişkenlerinden anında yardımcı CSS oluşturun.
• Daha kolay dağıtım — üretimde Node.js gerekmez, CI'da derleme adımı yoktur ve Docker imajınızda npm bulunmaz.

SCSS'ye, scssphp ile aynı fikri getiriyor — tüm derleyici, PHP ile.

Ne yapar?

• İçeriğinizde bulunan sınıf adlarından TailwindCSS v4.3.3 yardımcı kümesini, varyantları ve keyfi değerleri derler.
• Yönergelerin tamamını çözümler: @import (tailwindcss ve tailwindcss/utilities gibi sanal modüller ile reference içe aktarımları dahil), @theme, @apply, @utility, @variant, @custom-variant, @layer, @plugin ve @source.
• Tailwind'ın CSS işlevlerini uygular: theme(), --theme(), --spacing() ve --alpha(); ayrıca color-mix() → oklab() dönüşümünü ve CSS dönüşümlerini sağlar; bunları TailwindCSS LightningCSS'ye devreder.
• @import dosya sisteminden iç içe içe aktarımlar, yinelenenlerin kaldırılması ve özel çözümleyicilerle veya satır içi CSS dizelerinden çözümler.
• Preflight'ı (Tailwind temel sıfırlaması), önek desteğini, @property geri dönüşlerini, satıcı öneklerini ve keyframe'lerin yukarı taşınmasını içerir.
• Sınıf adı oluşturma, çakışma çözümü ve bileşen varyantları için cn(), merge(), join() ve variants()/compose() paketlerini içerir.
• Tipografi ve formlar eklentilerinin yanı sıra özel eklentiler için eklenti API (addUtilities, matchUtilities, addComponents, addVariant, theme, …) sunar.
• @tailwindcss/cli derleme seçeneklerini içeren bir CLI (bin/tailwindphp), ayrıca dosya tabanlı çıktı önbelleği, kalıcı derleyici durumu önbelleği ve üretim için bir CSS küçültücüsü sağlar.

Ne değildir

TailwindPHP bir CSS derleyicisidir, düzenleyici araç zinciri değildir. Tailwind ekosisteminin IntelliSense, otomatik tamamlama, sınıf sıralama ve kaynak eşlemeleri gibi IDE'ye yönelik bileşenlerini bilerek içermez; çünkü bunlar düzenleyici özellikleridir, CSS üretiminin parçası değildir. CSS üreten her şey kapsam dahilindedir; düzenleyicinize güç verenler kapsam dışındadır.

Nereden başlamalı

• Başlarken — paketi yükleyin ve ilk stil sayfanızı oluşturun.
• Kullanım — içeriği tarayın, temayı özelleştirin ve Tailwind yönergelerini kullanın.
• Sınıf Yardımcıları — cn(), merge(), join() ve variants().
• Eklentiler — tipografi, formlar ve kendi eklentinizi yazma.
• API — tw yüzeyinin tamamı ve TailwindCompiler örneği.
• CLI — dosya tabanlı derlemeler ve izleme modu için bin/tailwindphp.
• İleri Düzey — mimari, önbellekleme, performans ve uyumluluk notları.