TailwindPHP
نقل لـ TailwindCSS 4.x إلى PHP. أنشئ أدوات Tailwind المساعدة CSS في PHP، بلا Node.js ولا خطوة بناء. يتضمن cn() وtailwind-merge وCVA وإضافتي typography وforms، وCLI.
composer require tailwindphp/tailwindphpأحدث إصدار v1.7.0 MIT PHP 8.2+
use function TailwindPHP\merge;
merge('px-2 py-1 bg-red-500', 'px-4 bg-blue-500');
// => 'py-1 px-4 bg-blue-500'
// Conflict resolution is variant-aware
merge('hover:bg-red-500', 'hover:bg-blue-500');
// => 'hover:bg-blue-500'في التطبيق العملي
مرّر الترميز وملف إدخال CSS اختياريًا في استدعاء واحد إلى PHP لتحصل على ورقة أنماط.
إنشاء CSS من PHP
يفحص tw::generate() الترميز بحثًا عن أسماء الأصناف، ويعيد فقط CSS التي تحتاج إليها تلك الأصناف. يقبل الوسيط الثاني إدخال CSS، لذا يصبح اللون المحدد في @theme أداة مساعدة.
ينشئ cn() سلاسل الأصناف ويحل تعارضات Tailwind، بحيث تسود الأداة المساعدة المتعارضة الأخيرة.
use TailwindPHP\tw;
$css = tw::generate(
'<div class="bg-brand p-4">Hello</div>',
'@import "tailwindcss"; @theme { --color-brand: #3b82f6; }'
);
// .bg-brand now resolves to var(--color-brand)use function TailwindPHP\cn;
cn('px-2 py-1', 'px-4'); // 'py-1 px-4'
cn('btn', ['btn-primary' => true]); // 'btn btn-primary'PHP خالص
بلا Node.js ولا خطوة بناء. يعمل على PHP 8.2+ مع الإضافتين القياسيتين mbstring وctype. نفّذ composer require وابدأ.
يتتبع TailwindCSS v4.3.3
نقل لـ Tailwind v4.3.3 مع الأدوات المساعدة والمتغيرات والتوجيهات نفسها. الاختلافات المعروفة عن Tailwind موثقة.
أكثر من 4,400 اختبار
يُتحقق من المخرجات باستخدام مجموعات اختبارات TailwindCSS نفسها، المستخرجة من المصدر TypeScript والمعاد تشغيلها مع كل دفعة.
كل أداة مساعدة ومتغير
مجموعة الأدوات المساعدة كاملة وكل المتغيرات: التحويم والتركيز والتجاوب والوضع الداكن واستعلامات الحاويات والقيم الاعتباطية.
توجيهات CSS
تُحلل التوجيهات @import و@theme و@apply و@utility و@custom-variant و@layer و@plugin و@source وتُحل في PHP.
التوليد أثناء التشغيل
أنشئ الأدوات المساعدة CSS فورًا من HTML أو محتوى قاعدة البيانات أو متغيرات القوالب. لا حاجة إلى خطوة بناء.
كل ما تحتاجه مضمّن
cn() وmerge() وjoin() وvariants(): نُقلت clsx وtailwind-merge وCVA إلى PHP، بلا حزم إضافية.
الإضافات
نُقلت @tailwindcss/typography و@tailwindcss/forms إلى PHP، مع إضافة PHP من النوع API لإنشاء أدواتك المساعدة ومكوناتك.
CLI
ينشئ bin/tailwindphp ورقة أنماط من ملف إدخال CSS باستخدام -i و-o و--watch و--minify.
افحص السمة
اقرأ قيم الخصائص الأولية والمحسوبة والألوان ونقاط التوقف والتباعد لأي صنف مباشرةً من PHP.
ذاكرة التخزين المؤقت والمصغّر
يحافظ مصغّر CSS المضمّن وذاكرة التخزين المؤقت للملفات ذات مدة الصلاحية TTL على سرعة عمليات البناء المتكررة وخفة المخرجات.
إطارا عمل WordPress وPHP
انشر السمات والإضافات المعتمدة على Tailwind بلا Node.js في حزمة التقنيات. TailwindPHP هو اعتماد Composer واحد.
لماذا TailwindPHP؟
بيئة تشغيل واحدة في الإنتاج
عادةً ما يتطلب مشروع PHP الذي يعتمد Tailwind أيضًا Node.js وتثبيت npm وخطوة بناء في CI وDocker. بدلًا من ذلك، يترجم TailwindPHP ملف CSS داخل عملية PHP.
CSS للمحتوى المعروف أثناء التشغيل
يمكن تمرير الترميز من قاعدة بيانات أو إدخال المستخدم أو متغير قالب مباشرةً إلى tw::generate()، ليعيد فقط CSS التي تحتاج إليها أصنافه.
تم التحقق منه مقابل إصدار ثابت من Tailwind
تُستخرج حالات الاختبار من مصدر Tailwind المثبّت في المستودع وتُشغّل على مخرجات PHP، لذا يكشف CI أي اختلاف. جرى التحقق من الإصدار 1.7.0 مقابل Tailwind v4.3.3 باستخدام 4,427 اختبارًا.
CSS لكل صفحة من مترجم واحد
ترجم السمة مرة واحدة باستخدام tw::compile()، ثم استدعِ generateExact() لكل صفحة. يعيد كل استدعاء ما سينتجه tw::generate() بارد لتلك الصفحة، دون تحليل السمة مجددًا.
مقارنة مع
توفر Tailwind Labs طرقها الخاصة لبناء Tailwind CSS. إليك أوجه اختلاف TailwindPHP.
| الأداة | مناسب لـ | الاختلاف عن TailwindPHP |
|---|---|---|
| Tailwind CLI (@tailwindcss/cli) | مناسب لـأداة سطر الأوامر الخاصة بـTailwind، تُثبّت من npm. تفحص ملفات HTML والمكونات والقوالب بحثًا عن أسماء الأصناف، ثم تكتب الأنماط المطابقة في ملف CSS ثابت. | الاختلاف عن TailwindPHPيترجم TailwindPHP داخل PHP بلا تثبيت Node.js أو npm. ويتتبع إصدار Tailwind ثابتًا (v4.3.3 في 1.7.0)، ويُظهر معياره الخاص أن الأصل TypeScript أسرع في تنفيذ العمليات منخفضة المستوى. |
| Tailwind مستقل CLI | مناسب لـTailwind CLI كملف تنفيذي مستقل، للمشاريع التي تريد استخدامه دون تثبيت Node.js. | الاختلاف عن TailwindPHPالملف التنفيذي برنامج ثنائي منفصل يعمل كخطوة بناء. أما TailwindPHP فهو حزمة Composer يستدعيها كود PHP، ويمكنها أيضًا إنشاء CSS وقت الطلب من محتوى قاعدة البيانات أو متغيرات القوالب. |
| Tailwind Play CDN | مناسب لـوسم script يشغّل Tailwind في المتصفح لتجربته بلا خطوة بناء. وتوضح وثائق Tailwind أنه مصمم للتطوير وليس للاستخدام في الإنتاج. | الاختلاف عن TailwindPHPلا يحتاج TailwindPHP إلى خطوة بناء أيضًا، لكنه ينشئ CSS في PHP على الخادم ويعيده كسلسلة، مثلًا لكتابته في ورقة أنماط. |
الأسئلة والأجوبة
إجابات موجزة من توثيق TailwindPHP.
يتتبع الإصدار 1.7.0 Tailwind CSS v4.3.3. وأُعيد استخراج مجموعات اختباراته وفقًا لذلك الإصدار.
تُختبر المخرجات مقابل حالات مستخرجة من ملفات اختبارات Tailwind نفسها. ويسجل سجل تغييرات الإصدار 1.7.0 بضعة اختلافات في التسلسل؛ فمثلًا، يُبقي .p-0 على padding: 0px، بينما يصدر CLI المرجعي padding: 0.
لا. الإضافات PHP: نُقلت إضافتا typography وforms، ويمكنك كتابة إضافاتك بالاستناد إلى PHP من النوع API وتسجيلها باستخدام registerPlugin(). ويؤدي استخدام اسم @plugin غير مسجل إلى ظهور خطأ.
في المعيار الخاص بالمشروع على PHP 8.4.5 وجهاز Apple M1، استغرق إنشاء صفحة كاملة نحو 14 ms لكل صفحة. مع الإدخال المتكرر، تتخطى ذاكرة تخزين الملفات المؤقتة الترجمة، ويعيد مترجم طويل الأمد ذو generateExact() استخدام السمة المحللة.
لا. استُبعدت عمدًا ميزات IntelliSense والإكمال التلقائي وترتيب الأصناف وخرائط المصدر. يقتصر TailwindPHP على إنشاء CSS.
PHP 8.2 أو أحدث، مع إضافتي ctype وmbstring. يحدد composer.json إصدار PHP، ويشغّل CI مجموعة الاختبارات على PHP 8.2 و8.3 و8.4.
ثبّت الحزمة باستخدام Composer واتبع دليل البدء لإنشاء أول ورقة أنماط من PHP.