php microsite boilerplate

PHP microsite boilerplate

PHP Microsite Boilerplate هو إطار PHP لإنشاء مواقع ويب بسيطة ، لكنها وظيفية وسريعة وآمنة في كل بيئة بشكل أساسي.

تتطلب معظم الأطر وحتى الغلايات عملية إعداد مرهقة ، حيث تحتاج إلى تثبيت تبعيات متعددة. هذا يؤدي إلى حمولة كبيرة من الكود ، والتي لا تحتاجها في كثير من الأحيان. كل هذه التعقيد هو أيضًا خطر محتمل لموقع الويب الخاص بك. علاوة على ذلك ، لا يمكن في كثير من الأحيان استخدام معظم الحلول ، إذا كنت بحاجة إلى نشرها على أرخص خطة استضافة مشتركة.

يريد هذا المشروع تزويدك بإطار وقالب لهذه الحالة الدقيقة:

• تحتاج إلى بناء موقع ويب صغير إلى حد ما ، مع بعض الوظائف.
• يمكنك اختيار PHP ، لأنك تريد القيام برمجة نصية من جانب الخادم ، في حين أن PHP ربما هي أيضًا اللغة الوحيدة ، التي تعمل بشكل أساسي على جميع خيارات الاستضافة.
• أنت تبني هذا الشيء بمفردك أو بحد أقصى شخص آخر ، مما يجعل أفضل الممارسات ، ولكن بنية التعليمات البرمجية المعقدة أكثر من غير ضروري أكثر من مفهوم مفيد.
• تحتاج إلى إنجازها بسرعة ، بينما لا ترغب في تقديم تنازلات فيما يتعلق بالأمان أو الأداء.
• لذلك أنت لا تهتم بالكود النظيفة كثيرًا ؛).

العرض التوضيحي: https://phpmicrosite.jenskuerschner.de/

الميزات الرئيسية

• توجيه سهل.
• تطبيق الويب التقدمي (PWA) أعدت.
• أعدت متعددة اللغة.
• Directus CMS تكامل (بما في ذلك ذاكرة التخزين المؤقت المحلية).
• Docker يؤلف للتنمية المحلية.
• تضمنت Tailwindcss (اختياري).
• إجمالي الناتج المحلي و CCPA جاهز.
• ذاكرة التخزين المؤقت للخدمة الذكية.
• دعم GetText لـ Easy Translation (+ عاكسة إذا لم يتم تثبيتها على الخادم).
• تحسين محركات البحث الأمثل.
• توليد خريطة sitemap الآلية.
• الأمثل للمشاركة الاجتماعية.
• السرعة-و GDPR المحسّنة على YouTube-Cemration.
• اختياري CSS وتحسين JavaScript مع البرامج النصية للبناء المعدة.
• وثائق واسعة النطاق في الرمز.
• رؤوس الأمن (.htaccess أو عبر PHP)
• ميزات أمان متعددة (معظمها يتطلب خادم Apache!)
• على استعداد لتشغيل GIT نشر.
• تم تطويره لجعله من السهل للغاية إزالة الميزات أو إضافة الأشياء الخاصة بك.

الاستخدام

1. قم بتنزيل الفرع/العلامة المعنية وتحميله على مجلد موقع الويب الخاص بك - أو استنساخ الريبو كما تريد.

2. اضبطه على مشروعك:

• تحقق من ملف .htaccess ، إذا قمت بتشغيله على Apache. ضع في اعتبارك رؤوس وأماكن الأمان ، حيث يتم تحديد مجال/مسار (ابحث عن yourdomain.com).
• إذا لم تقم بتشغيله على Apache ، فتحقق من INDEX.PHP لإعداد رؤوس الأمان وتأكد من إرسال كل طلب (باستثناء الملفات) إلى index.php. تحقق من nginx_deployment.sh - إنه نص Bash تم تكوينه مسبقًا لإعداد خادم الويب Nginx الخاص بك.
• اضبط القيم داخل config.php وأيضًا ملفات العقل ، والتي تم ذكرها في التعليقات هناك. قم بإعداد اتصال بـ Directus CMS إذا تم استخدامه.
• تحقق من /templates/general_meta.php وإنشاء favicons المعنية.
• حدد صفحاتك في Routing.php. (العقل الإشعار القانوني وسياسة الخصوصية للبقاء متوافقة مع الناتج المحلي الإجمالي!)
• قم بإنشاء تلك الصفحات (كما هو محدد من قبل) كملفات PHP واحدة داخل /الصفحات.
• قم بإنشاء ملفات ذات صلة داخل /وحدة التحكم إذا لزم الأمر في قضيتك.
• تحقق من خيار Redirect التلقائي داخل اللغة المتعددة في index.php و base.js.
• قم ببناء موقع الويب بهذه الصفحات ، و style.css ، و base.js. ضع في اعتبارك تقليل هذه الملفات أو ضبط الطريقة التي يتم بها تضمينها على /templates/header.php و /templates/footer.php. إذا كنت تستخدم برنامج Build Build ، فلا داعي للقلق بشأن هذا الجزء.
• اضبط تذييل at /templates/footer.php على احتياجاتك.
• ابحث عن مزيد من التفاصيل في الوثائق داخل الرمز - إنه ملعب موثق جيدًا!

3. هذا هو في الأساس فيما يتعلق بالتعديلات. يمكنك العثور على دليل إعداد عينة أكثر تفصيلاً في منشور المدونة المتوسطة المقابلة هنا.

4. بناء المشروع ، بالكاد يعتمد على التكوين الخاص بك! إذا كنت تستخدم تكامل TailwindCSS ، فأنت بحاجة إلى استخدام البرنامج النصي المبني المرفق ، والذي يتطلب nodejs! إذا كنت تسير بشكل واضح ، فيمكنك تخطي ذلك. ومع ذلك ، فإن عدم استخدام البرامج النصية للبناء لن يندمج ملفات CSS و JS. لذلك ، إن أمكن لك ، فلا ينصح به. للبناء:

• تأكد من وجودك ضمن الدليل الجذر للمشروع مع المحطة الخاصة بك.
• تشغيل npm install .
• تشغيل npm run build لترك السحر يحدث.
• هذا كل شيء. لا تتردد في القيام بذلك يدويًا على جهازك المحلي وتحميله على مضيفك - أو استخدام بعض خطوط الأنابيب في أي أداة تستخدمها.

راجع للشغل: يوصى باستخدام خدمة CDN (مثل CloudFlare) من أجل تسريعها أكثر.

إعداد التنمية المحلية

للتنمية المحلية ، يمكنك الاستفادة من Docker-corm.yml

1. قم بتحديث اسم الحاوية في ملف YML.
2. تنزيل وتثبيت سطح المكتب Docker.
3. اضبط $the_page_url في config.php مؤقتًا إلى "/".
4. قم بتشغيل docker-compose up -d في المحطة في دليل الجذر للمشروع.
5. افتح المشروع في localhost:80 (ضع في اعتبارك أنك قد ترى خطأ SSL - لا ينبغي أن يكون مانعًا) ،
6. ترميز واختبار سعيد.

المساهمة

أي شخص مرحب به للمساهمة ، ولكن الاطلاع على الإرشادات:

• تقارير الأخطاء
• طلبات الميزة
• طلبات سحب

رخصة

الرمز متاح بموجب ترخيص GPL 3.0. يمكنك أن تفعل أي شيء معها بشكل أساسي ، ولكن ضع في اعتبارك أنه إذا كنت ترغب في توزيع عملك بناءً على هذا الرمز ، فيجب أن يكون عملك مرخصًا أيضًا. هذا يعني أنه يمكنك بسهولة إنشاء موقع الويب الخاص بك به ، نظرًا لأن هذا ليس توزيعًا. سيكون التوزيع هو الحال ، إذا قمت ببيع مشروع بناءً على هذا الرمز للآخرين أو إذا قمت بإنشاء مشاريع عامة (بغض النظر عما إذا كنت تبيعها أم لا). حتى هذا سيكون على ما يرام ، طالما أنك ترخيص تلك المشاريع أيضا مع GPL. :) تحقق من ملف الترخيص للحصول على جميع التفاصيل.

مستوحاة من

وقد استلهم هذا الرمز من HTML5 Boilerplate.