php microsite boilerplate

PHP MicroSite Boilerplate

PHP MicroSite Boilerplate เป็นเฟรมเวิร์ก PHP เพื่อสร้างเว็บไซต์ที่เรียบง่าย แต่ใช้งานได้อย่างรวดเร็วและปลอดภัยในทุกสภาพแวดล้อม

เฟรมเวิร์กส่วนใหญ่และแม้กระทั่งหม้อไอน้ำต้องใช้กระบวนการตั้งค่าที่เหนื่อยล้าซึ่งคุณต้องติดตั้งการพึ่งพาหลาย ๆ ครั้ง สิ่งนี้นำไปสู่รหัสเหนือศีรษะขนาดใหญ่ซึ่งคุณมักไม่ต้องการ ความซับซ้อนทั้งหมดเหล่านั้นยังเป็นความเสี่ยงที่อาจเกิดขึ้นสำหรับเว็บไซต์ของคุณ นอกจากนี้ยังเป็นไปไม่ได้ที่จะใช้โซลูชั่นส่วนใหญ่หากคุณต้องการปรับใช้กับแผนโฮสติ้งที่ใช้ร่วมกันที่ถูกที่สุด

โครงการนี้ต้องการให้เฟรมเวิร์กและเทมเพลตสำหรับกรณีนี้:

• คุณต้องสร้างเว็บไซต์ที่ค่อนข้างเล็กด้วยฟังก์ชั่นบางอย่าง
• คุณเลือก PHP เพราะคุณต้องการทำสคริปต์ฝั่งเซิร์ฟเวอร์ในขณะที่ PHP อาจเป็นภาษาเดียวที่ทำงานบนตัวเลือกโฮสติ้งทั้งหมดโดยทั่วไป
• คุณสร้างสิ่งนี้ด้วยตัวคุณเองหรือมีบุคคลอื่นสูงสุด 1 คนซึ่งทำให้การปฏิบัติที่ดีที่สุด แต่โครงสร้างรหัสที่ซับซ้อนของค่าใช้จ่ายที่ไม่จำเป็นมากกว่าแนวคิดที่เป็นประโยชน์
• คุณต้องทำให้เสร็จเร็วในขณะที่คุณไม่ต้องการประนีประนอมเกี่ยวกับความปลอดภัยหรือประสิทธิภาพ
• ดังนั้นคุณไม่สนใจรหัสที่สะอาดมาก)

การสาธิต: https://phpmicroite.jenskuerschner.de/

คุณสมบัติที่สำคัญ

• การกำหนดเส้นทางง่าย
• Progressive Web App (PWA) จัดทำขึ้น
• เตรียมหลายภาษา
• การรวม Directus CMS (รวมแคชท้องถิ่น)
• นักเทียบท่าเขียนเพื่อการพัฒนาในท้องถิ่น
• Tailwindcss รวม (ไม่บังคับ)
• GDPR และ CCPA พร้อม
• แคชผู้ให้บริการอัจฉริยะ
• GetText รองรับการแปลง่าย (+ ทางเลือกหากไม่ได้ติดตั้งบนเซิร์ฟเวอร์)
• SEO ปรับให้เหมาะสม
• การสร้างแผนผังเว็บไซต์อัตโนมัติ
• ปรับให้เหมาะสมสำหรับการแบ่งปันทางสังคม
• ความเร็วในการรวมตัวของ YouTube ที่ได้รับการปรับปรุงด้วย GDPR
• การเพิ่มประสิทธิภาพ CSS และ JavaScript ด้วยสคริปต์ Build ที่เตรียมไว้
• เอกสารในรหัสที่กว้างขวาง
• ส่วนหัวความปลอดภัย (.htaccess หรือผ่าน PHP)
• คุณสมบัติความปลอดภัยหลายอย่าง (ส่วนใหญ่ต้องใช้เซิร์ฟเวอร์ Apache!)
• เตรียมพร้อมที่จะเรียกใช้การปรับใช้ Git
• พัฒนาขึ้นเพื่อให้ง่ายมากสำหรับคุณในการลบคุณสมบัติหรือเพิ่มสิ่งของของคุณเอง

การใช้งาน

1. ดาวน์โหลดสาขา/แท็กที่เกี่ยวข้องและอัปโหลดไปยังโฟลเดอร์ของเว็บไซต์ของคุณ - หรือโคลน repo ตามที่คุณต้องการ

2. ปรับให้เข้ากับโครงการของคุณ:

• ตรวจสอบไฟล์. htaccess หากคุณเรียกใช้บน Apache คำนึงถึงส่วนหัวและสถานที่รักษาความปลอดภัยที่ระบุโดเมน/เส้นทาง (มองหา ourdomain.com)
• หากคุณไม่เรียกใช้บน Apache ให้ตรวจสอบ index.php สำหรับการตั้งค่าส่วนหัวความปลอดภัยและตรวจสอบให้แน่ใจว่าทุกคำขอ (ยกเว้นไฟล์) จะส่งไปยัง index.php ตรวจสอบ nginx_deployment.sh - เป็นสคริปต์ Bash ที่กำหนดค่าล่วงหน้าเพื่อตั้งค่า Nginx Webserver ของคุณ
• ปรับค่าภายใน config.php และไฟล์ Mind ซึ่งกล่าวถึงในความคิดเห็นที่นั่น ตั้งค่าการเชื่อมต่อกับ Directus CMS ของคุณหากใช้
• ตรวจสอบ /templates/general_meta.php และสร้าง favicons ที่เกี่ยวข้อง
• กำหนดหน้าของคุณที่เส้นทาง. php (การแจ้งเตือนทางกฎหมายและนโยบายความเป็นส่วนตัวเพื่อให้เป็นไปตามมาตรฐาน GDPR!)
• สร้างหน้าเหล่านั้น (ตามที่ระบุไว้ก่อนหน้า) เป็นไฟล์ PHP เดียวภายใน /หน้า
• สร้างไฟล์ที่เกี่ยวข้องภายใน /คอนโทรลเลอร์หากจำเป็นในกรณีของคุณ
• ตรวจสอบตัวเลือกเพื่อเปลี่ยนทิศทางอัตโนมัติภายในหลายภาษาที่ index.php และ base.js.
• สร้างเว็บไซต์ด้วยหน้าเหล่านั้น style.css และ base.js. ในการลดไฟล์เหล่านั้นหรือปรับวิธีที่พวกเขาได้รับที่ /templates/header.php และ /templates/footer.php หากคุณใช้สคริปต์สร้างที่เตรียมไว้คุณไม่จำเป็นต้องกังวลเกี่ยวกับส่วนนี้
• ปรับส่วนท้ายที่ /templates/footer.php ตามความต้องการของคุณ
• ค้นหารายละเอียดเพิ่มเติมในเอกสารในรหัส - เป็นสนามเด็กเล่นที่ได้รับการบันทึกไว้อย่างดี!

3. นั่นคือโดยพื้นฐานแล้วเกี่ยวกับการปรับเปลี่ยน คุณสามารถค้นหาคู่มือการตั้งค่าตัวอย่างโดยละเอียดเพิ่มเติมได้ที่โพสต์บล็อกกลางที่เกี่ยวข้องได้ที่นี่

4. การสร้างโครงการแทบจะขึ้นอยู่กับการกำหนดค่าของคุณ! หากคุณใช้การรวม TailWindCSS คุณต้องใช้สคริปต์บิลด์ที่ให้มาซึ่งต้องใช้ NodeJS! หากคุณกำลังจะธรรมดาคุณสามารถข้ามไปได้ อย่างไรก็ตามการไม่ใช้สคริปต์ Build จะไม่รวมและลดไฟล์ CSS และ JS ดังนั้นถ้าเป็นไปได้สำหรับคุณก็ไม่ค่อยแนะนำ สำหรับอาคาร:

• ตรวจสอบให้แน่ใจว่าคุณอยู่ในไดเรกทอรีรากของโครงการพร้อมเทอร์มินัลของคุณ
• เรียกใช้ npm install
• เรียกใช้ npm run build เพื่อให้เวทมนตร์เกิดขึ้น
• แค่นั้นแค่นั้น อย่าลังเลที่จะทำสิ่งนี้ด้วยตนเองบนเครื่องในพื้นที่ของคุณและอัปโหลดไปยังโฮสต์ของคุณ - หรือใช้ท่อสร้างบางอย่างที่เครื่องมือใดก็ตามที่คุณใช้

BTW: ขอแนะนำให้ใช้บริการ CDN (เช่น CloudFlare) เพื่อเพิ่มความเร็วให้มากขึ้น

การตั้งค่าการพัฒนาท้องถิ่น

สำหรับการพัฒนาในท้องถิ่นคุณสามารถใช้ประโยชน์จาก Docker-compose.yml ที่ให้มา

1. อัปเดตชื่อคอนเทนเนอร์ในไฟล์ YML
2. ดาวน์โหลดและติดตั้ง Docker Desktop
3. ปรับ $the_page_url ใน config.php ชั่วคราวเป็น "/"
4. เรียกใช้ docker-compose up -d ในเทอร์มินัลที่ไดเรกทอรีรากของโครงการ
5. เปิดโครงการที่ localhost:80 (โปรดทราบว่าคุณอาจเห็นข้อผิดพลาด SSL - ไม่ควรเป็นตัวบล็อก)
6. การเข้ารหัสและการทดสอบมีความสุข

การบริจาค

ทุกคนยินดีที่จะมีส่วนร่วม แต่คำนึงถึงแนวทาง:

• รายงานข้อผิดพลาด
• คำขอคุณสมบัติ
• ดึงคำขอ

ใบอนุญาต

รหัสมีอยู่ภายใต้ใบอนุญาต GPL 3.0 โดยทั่วไปคุณสามารถทำอะไรก็ได้ แต่ถ้าคุณต้องการแจกจ่ายงานของคุณตามรหัสนี้งานของคุณจะต้องได้รับใบอนุญาต GPL เช่นกัน ซึ่งหมายความว่าคุณสามารถสร้างเว็บไซต์ของคุณได้อย่างง่ายดายเนื่องจากไม่มีการกระจาย การแจกแจงจะเป็นกรณีหากคุณขายโครงการตามรหัสนี้ให้กับผู้อื่นหรือถ้าคุณสร้างโครงการสาธารณะ (ไม่ว่าคุณจะขายหรือไม่ก็ตาม) แม้จะเป็นเรื่องปกติตราบใดที่คุณอนุญาตให้ใช้โครงการเหล่านั้นด้วย GPL :) ตรวจสอบไฟล์ใบอนุญาตสำหรับรายละเอียดทั้งหมด

แรงบันดาลใจจาก

รหัสนี้ได้รับแรงบันดาลใจจากแผ่นหม้อต้ม HTML5