slim skeleton mvc app

แอป Slimphp 4 Skeleton MVC

เอกสารสำหรับเวอร์ชันของเฟรมเวิร์กนี้ตาม SLIMPHP 3 สามารถดูได้ที่นี่

นี่คือแอพพลิเคชั่นเว็บเทมเพลต (ขับเคลื่อนโดย Slimphp 4) ซึ่งสามารถขยายเพื่อสร้างเว็บแอปพลิเคชันที่ซับซ้อนมากขึ้น

แม้ว่าจะไม่จำเป็นต้องมีความเข้าใจอย่างเชี่ยวชาญเกี่ยวกับเฟรมเวิร์ก SlimphP 4 (https://www.slimframework.com/docs/v4/) เพื่อสร้างแอปพลิเคชันแอปพลิเคชันเทมเพลตนี้ความเข้าใจดังกล่าวจะช่วยเพิ่มขีดความสามารถของกรอบแอปพลิเคชันเทมเพลตนี้

คุณสมบัติ / ประโยชน์ของการใช้เฟรมเวิร์ก Slim MVC

• มันเพิ่มโครงสร้างมุมมองแบบจำลองลงในแอพพลิเคชั่นเว็บของคุณ ที่จริงแล้วฟังก์ชั่นการดูคอนโทรลเลอร์มากขึ้นพร้อมโฟลเดอร์ โมเดล ที่มีให้สำหรับที่อยู่อาศัยคลาสโมเดลของคุณ (ทำให้คุณมีความรับผิดชอบในการเลือกห้องสมุดการเข้าถึง ORM / ฐานข้อมูลใดก็ตามที่เหมาะสมกับความต้องการของคุณหรือสะดวกสบายที่สุด)

• จัดเตรียมโครงสร้างโฟลเดอร์ / ไดเรกทอรี Skeleton สำหรับแอปพลิเคชันของคุณ:

 ./path/to/newly/created/app
|-- config/
    |-- languages/
|       |-- en_US.php
|       `-- fr_CA.php
|   |-- app-settings.php
|   |-- app-settings-dist.php
|   |-- dependencies.php
|   |-- env.php
|   |-- env-dist.php
|   |-- ini-settings.php
|   `-- routes-and-middlewares.php
|
|-- logs/
|
|-- public/
|   |-- css/
|   |-- images/
|   |-- js/
|   `-- index.php
|
|-- src/
|   |-- controllers/
|   |-- layout-templates/
|   |-- models/
|   |-- views/
|   `-- AppErrorHandler.php
|
|-- tests/
|
|-- tmp/
|
|-- vendor/
|
|-- .gitignore
|-- composer.json
|-- composer.lock
`-- README.md

• ให้ฟังก์ชั่นผู้ช่วยบางอย่างเช่น smvc_uritostring ( psr http message uriinterface $ uri) , smvc_addquerystrparamtouri ( psr http message uriinterface $ uri, $ param_name, $ param_name SlimMvcToolsFunctionsStr เนมสเปซ

• จัดเตรียมรูปแบบการกำหนดเส้นทางอัตโนมัติสำหรับการทำแผนที่การร้องขอ URL ไปยังวิธีการในคลาสคอนโทรลเลอร์ที่เป็นคลาสย่อยของ SlimMvcToolsControllersBaseController คุณไม่จำเป็นต้องกำหนดเส้นทางใด ๆ สำหรับแอปพลิเคชันของคุณหากคุณปฏิบัติตามตัวควบคุมที่เข้ากันได้กับรูปแบบการกำหนดเส้นทาง

  • นอกจากนี้ยังรองรับการใช้งานโดยใช้ฟังก์ชั่น PHP Pure Slim (เช่นคุณสามารถกำหนดเส้นทางทั้งหมดหรือบางเส้นทางได้อย่างชัดเจน (แต่ละเส้นทางอาจหรือไม่อาจใช้ประโยชน์จากคลาสคอนโทรลเลอร์เป็นตัวจัดการเส้นทาง) และค่าไฟกลางสำหรับแอปพลิเคชันของคุณ

• เรือที่มีคลาส basecontroller (เช่น SlimMvcToolsControllersBaseController ) ที่ให้วิธีการตรวจสอบ (เข้าสู่ระบบ, ออกจากระบบและตรวจสอบสถานะการตรวจสอบสิทธิ์), รายการทั้งหมดในคลาสคอนโทรลเลอร์ทั้งหมดในแอปพลิเคชัน & 501 การตอบสนองและวิธีการสำหรับการแสดงผลมุมมอง PHP และไฟล์เลย์เอาต์โดยใช้น้ำหนักเบาและขยายได้อย่างง่ายดาย RotexSoft Filerenderer Renderer คลาส ดูชั้นเรียนสำหรับรายการวิธีการทั้งหมดที่สามารถใช้ในแอปพลิเคชันของคุณ

• จัดเตรียมสคริปต์บรรทัดคำสั่งสำหรับการสร้างคลาสคอนโทรลเลอร์ (ที่ขยาย SlimMvcToolsControllersBaseController หรือลูกหลานใด ๆ )

  • ./vendor/bin/smvc-create-controller บน *nix-like oses และ .vendorbinsmvc-create-controller.bat บน Windows
    • หมายเหตุ: ./vendor/bin/smvc-create-controller-wizard เป็นเวอร์ชันเชิงโต้ตอบของ ./vendor/bin/smvc-create-controller /bin/smvc-create-controller

• เรือที่มีการพึ่งพานักแต่งเพลง / นักบรรจุหีบห่อน้อยที่สุด (ทั้งหมดที่ใช้โดย SlimMvcToolsControllersBaseController ) เพื่อให้คุณสามารถรวมเฉพาะการพึ่งพาเพิ่มเติมที่เหมาะสมกับความต้องการเฉพาะของแอปพลิเคชันของคุณ ดังนั้นการลดความเป็นไปได้ของการพึ่งพาที่ไม่ได้ใช้ / ไม่จำเป็นในใบสมัครของคุณ แพ็คเกจต่อไปนี้ใช้ในเฟรมเวิร์กนี้:

  • Slim Framework เวอร์ชัน 4: สำหรับการกำหนดเส้นทางคำขอ HTTP ไปยังวิธีการดำเนินการในคลาสคอนโทรลเลอร์ (หรือการเรียกอื่น ๆ ที่ยอมรับได้โดย SLIM สำหรับการตอบสนองต่อคำขอที่ตรงกับเส้นทางที่กำหนด) และส่งการตอบกลับ HTTP กลับไปยังลูกค้า
  • File Renderer: สำหรับการแสดงเค้าโครง PHP และดูไฟล์ (ซึ่งโดยทั่วไปมีการผสมผสานของ PHP, HTML, CSS & JavaScript) ซึ่งจะถูกส่งกลับเป็น HTML ใน HTTP Response Bodies ไปยังลูกค้า ข้อความธรรมดา, JSON, XML และการตอบกลับที่ไม่ใช่ HTML อื่น ๆ สามารถปล่อยออกมาได้โดยตรงจากวิธีการดำเนินการคอนโทรลเลอร์ (พวกเขาไม่ต้องการการแสดงผลนี้)
  • Vespula Auth: แพ็คเกจการตรวจสอบความถูกต้องที่มีน้ำหนักเบาซึ่งใช้โดยการล็อกอินเริ่มต้นและการออกจากระบบใน Basecontroller เพื่อตรวจสอบสิทธิ์ผู้ใช้ SQLite DB ในหน่วยความจำใช้สำหรับการรับรองความถูกต้องโดยค่าเริ่มต้นคุณควรเปลี่ยนเป็น DB เชิงสัมพันธ์ที่เหมาะสมเช่น MySQL (ซึ่งแพ็คเกจนี้ยังสามารถรับรองได้)
  • Vespula Locale: แพ็คเกจน้ำหนักเบาอื่นสำหรับการจัดการสตริงที่มีการแปลในกรอบนี้ สิ่งต่าง ๆ เช่นข้อความแสดงข้อผิดพลาดระหว่างการเข้าสู่ระบบได้รับการจัดการโดยใช้อินสแตนซ์ของแพ็คเกจนี้เพื่อแสดงข้อความเหล่านั้นในภาษาที่ต้องการที่ผู้ใช้เลือก US English & Canadian French เป็นสองภาษากรอบนี้รองรับนอกกรอบ สามารถเพิ่มไฟล์สถานที่อื่น ๆ ลงในโฟลเดอร์ ./config/Languages ​​และรหัสสถานที่ของพวกเขาควรเพิ่มลงในคอนเทนเนอร์ ( $ container [containerkeys :: valid_locales] ) และลิงก์สำหรับภาษานั้นควรเพิ่มเทมเพลตเลย์เอาต์
  • Vespula Log: ตัวบันทึก PSR-3 ที่ใช้ตลอดทั้งกรอบนี้สำหรับการบันทึกเหตุการณ์ต่าง ๆ (เช่นเหตุการณ์เข้าสู่ระบบและการออกจากระบบที่ประสบความสำเร็จ ฯลฯ ) มันเบากว่าแพ็คเกจอื่น ๆ เช่น Monolog และค่อนข้างดี
  • สิว: ภาชนะฉีดพึ่งพาการพึ่งพาอย่างง่ายที่ใช้ในการใช้จ่าย power slimmvctools container (คอนเทนเนอร์ที่สอดคล้องกับ PSR-11 ที่จัดส่งด้วยเฟรมเวิร์กนี้)
  • Nyholm PSR7: การใช้งาน PHP7 อย่างรวดเร็วของ PSR-7 ที่ถูกฉีดเข้าไปใน SlimphP โดยกรอบนี้
  • เซิร์ฟเวอร์ Nyholm PSR7: คลาสผู้ช่วยในการจัดการคำขอเซิร์ฟเวอร์ PSR-7 ซึ่งใช้โดย SLIMPHP ภายในเฟรมเวิร์กนี้

  คุณควรดูวิธี การ สาธารณะ ที่ มีอยู่ใน slimmvctools controllers basecontroller ซึ่งคลาสคอนโทรลเลอร์ของแอป พลิ เค ชัน ทั้งหมดของคุณจะขยายออก ไป

• มุ่งมั่นที่จะยึดติดกับ ข้อความ PSR-7 HTTP และอินเทอร์เฟซ PSR/คอนเทนเนอร์ อย่างเคร่งครัดเพื่อให้ใช้งานได้ง่ายในการใช้งานที่แตกต่างกันของคำขอ PSR-7 และวัตถุตอบสนองและคอนเทนเนอร์ที่สอดคล้องกับ PSR/คอนเทนเนอร์

ความต้องการ

• PHP 7.2+ (สำหรับเวอร์ชัน 3.x) หรือ PHP 7.4+ (สำหรับเวอร์ชัน 4.x) หรือ PHP 8.1+ (สำหรับเวอร์ชัน 5.x)
• PDO SQLITE (3) ส่วนขยายสำหรับการตรวจสอบความถูกต้องในสภาพแวดล้อมที่ไม่ได้ผลิต
• นักแต่งเพลง (https://getComposer.org)

เอกสาร

• คู่มือเริ่มต้นด่วน
• ฟังก์ชั่น MVC
• การใช้งานโลกแห่งความเป็นจริง: การสร้างแอปพลิเคชั่นแคตตาล็อกภาพยนตร์
• ตัวอย่างบรรทัดคำสั่งทั้งหมดสมมติว่าคุณได้เปลี่ยนไดเรกทอรีเป็นโฟลเดอร์รูทของแอปพลิเคชันที่คุณสร้างขึ้นใหม่
• โปรดส่งปัญหาหรือคำขอดึงหากคุณพบปัญหาใด ๆ กับเอกสาร

การแตกแขนง

นี่คือสาขาในที่เก็บนี้:

• Master: มีรหัสสำหรับเวอร์ชันหลักล่าสุดของเฟรมเวิร์กนี้

  ควรมีสาขา Slim-#-Edition-Versions-XX ที่จะซิงค์กับต้นแบบและซึ่งจะมีการติดแท็กรุ่นใหญ่ล่าสุด Composer.json ในสาขานี้จะต้องใช้ Rotexsoft/Slim-Skeleton-MVC-mvc เวอร์ชันที่เสถียรล่าสุดเมื่อเทียบกับรุ่น dev-master ที่จะต้องใช้ในนักแต่งเพลง Json ในสาขาหลัก

• Slim-4-Edition-Versions-5.x: มีรหัสสำหรับแพ็คเกจ 5.x ของแพ็คเกจนี้ (กำลังซิงค์กับต้นแบบจนกระทั่งรุ่นใหม่ 6.x เริ่มพัฒนาบน Master)
• Slim-4-Edition-Versions-4.x: มีรหัสสำหรับเวอร์ชัน 4.x ของแพ็คเกจนี้ ไม่มีคุณสมบัติใหม่เท่านั้นที่ยอมรับการแก้ไขข้อบกพร่อง
• Slim-3-Edition: มีรหัสสำหรับรุ่น 3.x ของแพ็คเกจนี้ ไม่มีคุณสมบัติใหม่เท่านั้นที่ยอมรับการแก้ไขข้อบกพร่อง
• 1.x: มีรหัสสำหรับรุ่น 1.x ของแพ็คเกจนี้ ถูกทอดทิ้ง
• Project-Website: มีรหัสสำหรับเว็บไซต์ documetation สำหรับโครงการนี้ (https://rotexsoft.github.io/slim-skeleton-mvc-app/)
  • สาขาโครงการไซต์สร้างขึ้นในเดือนพฤษภาคม 2567 และกำลังได้รับการพัฒนา จะลบประกาศนี้เมื่อเว็บไซต์เอกสารพร้อมที่จะไป สำหรับตอนนี้ยังคงอ่านเอกสารในสาขาสำหรับเวอร์ชันของเฟรมเวิร์กนี้ที่คุณใช้อยู่

ปัญหา

• โปรดส่งปัญหาหรือคำขอดึงหากคุณพบปัญหาใด ๆ กับแอพ Skeleton นี้
• หากคุณกำลังแนะนำการปรับปรุงโปรดสร้างปัญหาก่อนเพื่อให้สามารถพิจารณาได้ก่อนที่จะส่งคำขอดึง