متقدم

TailwindPHP نقل مباشر بنسبة 1:1 لـ TailwindCSS 4.x إلى PHP خالص. ومبدأه الأساسي هو الأمانة: تعكس قاعدة الشيفرة المشروع الأصلي TypeScript ملفًا بملف — بالأسماء والتنظيم نفسيهما — بحيث يكون لكل سلوك في TailwindCSS موضع واضح في PHP، ويمكن تتبع تغييرات المنبع دون تخمين.

كل ما لا يشكل جزءًا من منفذ TailwindCSS موجود في مكان واحد محدد بوضوح: src/_tailwindphp/. يضم هذا المجلد الأدوات المساعدة الخاصة بـPHP — إعادة تنفيذ تحويلات Rust ‏lightningcss (LightningCss.php)، ومصغّر CSS (CssMinifier.php)، ومنافذ المكتبات المرافقة (lib/: clsx وtailwind-merge وCVA) ضمن مساحة الأسماء TailwindPHP\Lib\*. وكل ما عدا ذلك ضمن src/ يقابل ملفًا في TailwindCSS.

يُتحقق من الصحة بمقارنتها بمجموعة اختبارات Tailwind نفسها. تُستخرج حالات الاختبار مباشرة من ملفات .test.ts الخاصة بـTailwindCSS وتُشغّل على مخرجات PHP، لذا فإن أي اختلاف عن السلوك الأصلي يؤدي فورًا إلى فشل الاختبار. والنتيجة 4,427 اختبارًا ناجحًا (الإصدار 1.7.0، مقابل TailwindCSS v4.3.3)، تغطي الأدوات المساعدة والمتغيرات والتوجيهات والإضافات وCLI والمكتبات المرافقة.

الصفحات

• البنية — مسار التجميع (تحليل ← مسح ← تجميع ← تحسين ← تصغير)، وتخطيط المصدر، والمكافئ في lightningcss، واتفاقية العلامة @port-deviation.
• التخزين المؤقت والتصغير — ذاكرة التخزين المؤقت للملفات الناتجة (cache وcacheTtl وclearCache())، وذاكرة حالة المترجم (stateCacheFile)، وما يفعله مصغّر CSS.
• الأداء والاختبار — التحسينات الخاصة بـPHP، وكيفية التحقق من التكافؤ مع TailwindCSS، وبوابة جودة الكود.
• التوافق والترقية — المتطلبات، وإصدار TailwindCSS المتتبّع، والاختلافات المعروفة عن TailwindCSS، وملاحظات الترقية لكل إصدار.