umvc

กรอบ UMVC

เวอร์ชัน 2.0.2-2024-12-13

เฟรมเวิร์กการใช้งานเว็บอย่างง่ายที่ใช้รูปแบบสถาปัตยกรรมแบบจำลองมุมมอง (MVC) (MVC)

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

• มุมมองที่ใช้ HTML/PHP อย่างง่ายพร้อมลำดับชั้นของการเรนเดอร์
• การเชื่อมต่อฐานข้อมูลที่ใช้ PDO พร้อมตัวสร้างแบบสอบถามแบบอาร์เรย์ (ปัจจุบันมีการใช้งาน MySQL เท่านั้น)
• คลาสรุ่นที่ใช้งานง่าย
• URL-Path ง่าย ๆ ในการแปลคอนโทรลเลอร์/วิธีการด้วยพารามิเตอร์อัตโนมัติผ่าน
• การสนับสนุนการโยกย้ายฐานข้อมูล
• ผู้ใช้เข้าสู่ระบบผ่าน SAML (โดยใช้คุณสมบัตินี้ composer require "simplesamlphp/simplesamlphp:^2.2" )

โมดูล

UMVC รองรับโมดูลดูการกำหนดค่า/ส่วนประกอบ

การสนับสนุนการแปลงรหัส

เฟรมเวิร์กรองรับการทดสอบการทำงานด้วยปลั๊กอินเฟรมเวิร์ก codeception ที่ติดตั้งทั่วโลกจะต้องเข้ากันได้กับต้องการ (ปัจจุบัน v3.1.2)

บรรทัดคำสั่ง

UMVC รองรับ CLI คุณสามารถสร้างคำสั่งของคุณเอง คำสั่งในตัวคือ:

• โยกย้าย

เรียกใช้คำสั่งเป็น php app $command $action $parameters

การติดตั้ง

เฟรมเวิร์กสามารถรวมอยู่ในโครงการของคุณด้วยนักแต่งเพลง Run composer require uhi67/umvc:dev-master ใหม่สามารถสร้างโครงการที่ว่างเปล่าได้โดยใช้ composer create-project --prefer-dist uhi67/umvc-app name สิ่งนี้จะช่วยให้คุณมีแอปพลิเคชันที่ว่างเปล่าใหม่โดยใช้ UMVC Framework ลงในไดเรกทอรีที่มีชื่อ เลือกชื่อที่คุณต้องการ

ขั้นตอนแรกในการสร้างแอปพลิเคชันของคุณโดยใช้ UMVC

คำเตือน: ส่วนนี้อยู่ระหว่างการก่อสร้าง เรียนรู้เพิ่มเติมเกี่ยวกับคลาสที่กล่าวถึงในการจัดวางของนิยามคลาส

1. สร้าง composer.json ของแอปพลิเคชันของคุณและรวมถึง uh67/umvc , EG composer init --name myname/myapp --require uhi67/umvc:*
2. เรียกใช้ composer update
3. คัดลอก vendor/uh67/umvc/app ไปยังรูทของแอปพลิเคชันของคุณ นี่คือตัวเรียกใช้คำสั่ง CLI
4. คัดลอก vendor/uh67/umvc/www/index.php และ .htaccess ไปยังไดเรกทอรี www ของแอปพลิเคชันของคุณ นี่คือเราเตอร์ของเว็บอินเตอร์เฟส
5. สร้างการกำหนดค่าแอปพลิเคชันของคุณในไฟล์ config/config.php ดูเทมเพลตใน vendor/uh67/umvc/config/config-template.php
6. สร้างไดเรกทอรี runtime เขียนโดยเว็บเซิร์ฟเวอร์เพื่อวางไฟล์ชั่วคราว
7. สร้างไดเรกทอรี www/assets ที่เขียนโดยเว็บเซิร์ฟเวอร์เพื่อวางไฟล์สินทรัพย์ที่แคชของส่วนประกอบต่างๆ

สร้างแอปพลิเคชันของคุณโดยใช้รูปแบบ MVC

1. สร้างคอนโทรลเลอร์ของคุณใน controllers DIR โดยใช้ appcontrollers เนมสเปซและรับมาจาก uhi67umvcController
2. สร้างมุมมองใน views DIR ในรูปแบบ PHTML อย่างง่ายและจัดระเบียบตามโครงสร้าง views/controller/action.php
3. สร้างโมเดลของคุณในไดเรกทอรี models โมเดลฐานข้อมูลคือ uhi67umvcModel , โมเดลฐานข้อมูล-น้อยคือ uhi67umvcBaseModel

หลักการพื้นฐานอื่น ๆ

1. การโยกย้ายมีไว้สำหรับการกำหนดเวอร์ชันและการบันทึกการเปลี่ยนแปลงฐานข้อมูลในซอร์สโค้ด วางขั้นตอนการโยกย้ายลงในไดเรกทอรี migrations
2. เลย์เอาต์เป็นมุมมองพิเศษในการฝังมุมมองอื่น ๆ ทั้งหมดภายใน วางเลย์เอาต์ในไดเรกทอรี views/layouts มุมมองสามารถโทรหามุมมองบางส่วนอื่น ๆ
3. คุณสามารถกำหนดคำสั่ง CLI ในไดเรกทอรี commands ที่ได้มาจากคลาส uhi67umvcCommand มีคำสั่งในตัวในกรอบ คำสั่ง php app แสดงคำสั่งที่มีอยู่ทั้งหมดทั้งในตัวและแบบกำหนดเอง
4. การสนับสนุนการแปลตามการแปลตามไฟล์อย่างง่ายนั้นอยู่ในตัว วางคำแปลของคุณลงในไฟล์ messges/la.php โดยที่ "la" เป็นภาษาที่คุณต้องการแปล

การกำหนดค่าส่วนประกอบและคุณสมบัติ

ส่วนประกอบทั้งหมดคลาส UMVC ส่วนใหญ่รวมถึงคลาสแอพหลักเองคือ A uhi67umvcComponent Component ใช้คุณสมบัติ คุณสมบัติ : Magic Getter และ Setter ใช้วิธี GetProperty และ SetProperty Component สามารถ กำหนดค่าได้ : ตัวสร้างยอมรับอาร์เรย์การกำหนดค่าที่มีค่าสำหรับคุณสมบัติสาธารณะ

ส่วนประกอบในตัว

1. MySqlConnection - เพื่อเชื่อมต่อกับฐานข้อมูล รวมถึง Builder SQL Query ปัจจุบันการใช้งาน Connection เพียงอย่างเดียว
2. FileCache - การใช้งาน CacheInterface เพียงอย่างเดียว
3. SamlAuth - การใช้งานเพียงอย่างเดียวสำหรับ AuthManager
4. L10n การแปลแบบง่าย ๆ , เริ่มต้นอัตโนมัติเริ่มต้น, แปลข้อความ UMVC เท่านั้น
5. L10nFile การแปลตามไฟล์เพื่อแปลข้อความของแอปพลิเคชันของคุณ

คลาสพื้นฐานอื่น ๆ ที่คุณสามารถใช้ได้

1. Form -วิดเจ็ตที่มีมุมมองในตัวเพื่อแสดงและประมวลผลรูปแบบ HTML โดยใช้โมเดลของคุณ
2. Grid (วิดเจ็ต แต่มุมมองในตัวยังคงหายไป)-เพื่อแสดงรายการโมเดลที่ถูกกรอง
3. Query - แสดงถึงการสืบค้น SQL แบบ parametrized และยืดหยุ่นในโครงสร้าง PHP คำสั่ง SQL สามารถสร้างได้จากมัน
4. Request - แสดงถึงคำขอ HTTP สามารถใช้เพื่อดึงข้อมูล GET และ POST พารามิเตอร์
5. Session - หมายถึงเซสชัน PHP ปัจจุบันสามารถใช้เพื่อรับและตั้งค่าตัวแปร

สคริปต์รายการ URL และการกำหนดเส้นทาง

สคริปต์รายการเดียวสำหรับเว็บแอปพลิเคชันคือ www/index.php ตามลำดับสคริปต์รายการเดียวสำหรับแอปพลิเคชัน CLI คือไฟล์ app ทั้งคู่จะต้องคัดลอกลงในไดเรกทอรีแอปพลิเคชันของคุณจาก vendor/uhi67/umvc/ ไดเรกทอรี

กฎ www/.htaccess เปลี่ยนเส้นทางคำขอที่ไม่พบทั้งหมดไปยัง www/index.php อย่างไรก็ตามสินทรัพย์คงที่จะเสิร์ฟโดยตรงจากไดเรกทอรี WWW เรียนรู้เพิ่มเติมเกี่ยวกับการให้บริการสินทรัพย์ห้องสมุดในภายหลัง

index.php เริ่มต้น AutoLoader โหลดการกำหนดค่าหลักสร้างวัตถุหลัก (คลาสที่กำหนดไว้ในการกำหนดค่าโดยปกติแล้ว uhi67/umvc/App หรือ Descendant) การกำหนดค่าหลักเป็นไปตามกฎของ Component ที่กำหนดค่าได้

การกำหนดเส้นทาง

URL ทั้งหมดที่เกิดขึ้นเป็น https: // myapp/acontroller/anaction ถูกประมวลผลด้วยวิธีต่อไปนี้:

uhi67/umvc/App แยกวิเคราะห์คำขอคำนวณคลาสคอนโทรลเลอร์จริง (มาจาก uhi67/umvc/Controller ) เพื่อใช้สร้างคอนโทรลเลอร์และเรียกใช้วิธีการดำเนินการที่ร้องขอ ดังในตัวอย่างข้างต้น Acontroller อ้างถึงคลาสคอนโทรลเลอร์ของคุณในไดเรกทอรี controllers ของคุณเป็น AcontrollerController และ ANACTION หมายถึงวิธีการกระทำ (เป็น ActionAnAction )

หากชื่อแอ็คชั่นหายไปจาก URL actionDefault จะถูกเรียกใช้ หากชื่อคอนโทรลเลอร์หายไปเช่นกันจะใช้ MainController ที่กำหนดค่าไว้ นอกจากนี้ยังเป็นไปได้ที่จะสร้าง URL ด้วยชื่อการกระทำของคอนโทรลเลอร์เริ่มต้นโดยไม่ระบุชื่อคอนโทรลเลอร์ - ข้อ จำกัด เพียงอย่างเดียวที่คุณไม่สามารถมีคอนโทรลเลอร์ที่มีชื่อเดียวกับการกระทำนี้

คำสั่ง Al CLI ที่เกิดขึ้นเป็น php app acontroller/anaction ถูกประมวลผลวิธีต่อไปนี้:

uhi67/umvc/App แยกวิเคราะห์คำขอคำนวณคลาสคอนโทรลเลอร์จริง (มาจาก uhi67/umvc/Command ) เพื่อใช้สร้างคอนโทรลเลอร์และเรียกใช้วิธีการดำเนินการที่ร้องขอ ดังในตัวอย่างข้างต้น Acontroller อ้างถึงคลาสคอนโทรลเลอร์ของคุณในไดเรกทอรี commands ของคุณเป็น AcontrollerController และ ANACTION หมายถึงวิธีการกระทำ (เป็น ActionAnAction ) คำสั่งในตัวสามารถเรียกใช้ในลักษณะเดียวกัน คำสั่งที่มีชื่อเดียวกันในแอปพลิเคชันของเราแทนที่คำสั่งในตัว

การใช้ URL ในการดำเนินการคอนโทรลเลอร์ของคุณ

ส่วนของคำขอ URL ปัจจุบันสามารถเข้าถึงได้เป็น:

• เส้นทาง: ส่วนเส้นทางที่ส่งผ่านไปยังคอนโทรลเลอร์ (ชื่อคอนโทรลเลอร์เปลี่ยนไปแล้ว)
• แบบสอบถาม: ส่วนการสืบค้นของคำขอเดิมเป็นอาร์เรย์ที่เชื่อมโยงกัน

ในการสร้าง URL ใหม่โดยใช้ชื่อคอนโทรลเลอร์และแอ็คชั่นและพารามิเตอร์ OptioAnl Qurey ให้ใช้หนึ่งในสิ่งต่อไปนี้:

• $ this-> app-> createUrl (['คอนโทรลเลอร์/การกระทำ', 'key' => 'queryValue', ... , '#' => 'fragment'])-ทุกส่วนเป็นทางเลือก
• ส่งคืน $ this-> app-> redirect ([... ])-เพื่อยุติการกระทำด้วยการเปลี่ยนเส้นทาง

ให้บริการสินทรัพย์ห้องสมุด

ในไฟล์มุมมองของคุณคุณสามารถอ้างอิงสินทรัพย์คงที่ของคุณที่อยู่ภายใต้ไดเรกทอรี www ในแบบคงที่เช่น <link href="/assets/css/app.css" rel="stylesheet"> ในทางตรงกันข้ามหากคุณต้องการอ้างถึงไฟล์สินทรัพย์ที่อยู่ที่ไหนสักแห่งในห้องสมุดผู้ขายที่สร้างขึ้นจากนักแต่งเพลงคุณสามารถใช้พวกเขาด้วยวิธีนี้:

• <script src="<?= $this->linkAssetFile('npm-asset/bootstrap/dist', 'js/bootstrap.bundle.min.js') ?>"></script>

ฟังก์ชั่น linkAssetFile คัดลอกไฟล์ทั้งหมดจากไดเรกทอรีในอาร์กิวเมนต์แรกลงในไดเรกทอรีแคชสินทรัพย์ภายใต้ www และสร้าง URL ที่ถูกต้องไปยังไฟล์ int ของอาร์กิวเมนต์ที่สอง หมายเหตุ: อาร์กิวเมนต์แรกระบุแพ็คเกจสินทรัพย์ เฉพาะการโทรครั้งแรกสำหรับแพ็คเกจใด ๆ คัดลอกไฟล์ การโทรที่ตามมาทั้งหมดไปยังแพ็คเกจเดียวกันจะสร้างลิงค์สำหรับไฟล์เท่านั้น

แคชสินทรัพย์จะถูกเทลงโดยคำสั่ง composer install แคชสินทรัพย์เป็น www/asset/cache เสมอและไม่สามารถกำหนดค่าได้

หัวข้ออื่น ๆ (เร็ว ๆ นี้)

• การตัดไม้
• โครงสร้างพื้นฐานเพื่ออัปเดตโมเดลโดยใช้แบบฟอร์ม
• การแบ่งหน้าและการกรองกริด
• การตรวจสอบแบบจำลอง
• ผู้ช่วย (คลาสที่มีวิธีการคงที่เท่านั้น)

-

ข้อมูลการพัฒนาเฟรมเวิร์ก

การติดตั้งแบบสแตนด์อโลนและการทดสอบหน่วยภายใน

พื้นที่เก็บข้อมูลนี้มีแอปพลิเคชันทดสอบในตัวสำหรับการทดสอบหน่วย codeception ภายใน วัตถุประสงค์เดียวของแอพทดสอบในไดเรกทอรี tests คือการสามารถเรียกใช้การทดสอบหน่วยและไม่ใช่แอปพลิเคชันตัวอย่างที่จะเริ่มต้นด้วย

ขั้นตอนการติดตั้งแบบสแตนด์อโลน:

• git clone
• composer update
• สร้าง tests/_data/test-config.php ตามเทมเพลต
• สร้างฐานข้อมูล umvc-test ตามการตั้งค่าฐานข้อมูลใน tests/_data/test-config.php
• เรียกใช้ php vendor/bin/codecept run unit สำหรับการทดสอบหน่วย

การทดสอบหน่วยเพิ่มเติมกำลังจะมา ...

การทดสอบใน Docker

สภาพแวดล้อมการทดสอบ Dockerized ในตัวสามารถใช้เพื่อทดสอบกับ PHP และฐานข้อมูลที่แตกต่างกัน

ขั้นตอน:

1. กำหนดค่าเวอร์ชันฐานข้อมูลที่ต้องการใน tests/docker-compose.yml (สร้างโคลนของไฟล์เทมเพลตนี้)
2. กำหนดค่าเวอร์ชัน PHP ใน tests/docker/Dockerfile (ขั้นตอนการติดตั้งส่วนขยายอาจเปลี่ยนไป)
3. กำหนดค่าพอร์ตที่ใช้แล้วและอูล์กฐานใน tests/.env
4. สร้างสแต็กโดยใช้ docker compose up --build -d (ใน tests DIR)
5. คอนเทนเนอร์ PHP ของคุณควรเป็น 'UMVC-PHP-1'
6. เรียกใช้การทดสอบหน่วยด้วย docker exec -it umvc-php-1 php vendor/bin/codecept run unit

เปลี่ยนบันทึก

เวอร์ชัน 2.0.2-"2024-12-13"

• urlpath, การแก้ไข baseurl
• ถอดดักการดีบักออก

เวอร์ชัน 2.0.1-"2024-12-04"

• ติดตั้ง :: creardir () ตอนนี้ลบไฟล์. gitkeep และ. gitignore

เวอร์ชัน 2.0-"2024-10-11"

• ต้องใช้ PHP 8.2
• แก้ไขการใช้งาน baseurl

เวอร์ชัน 1.4-2024-07-25

• แบบสอบถาม :: เพิ่ม FilterInreferredModels ()
• แคชที่ว่างเปล่า: ข้าม. gitignore ไฟล์
• คู่มือ UMVC และอ้างอิงแอป UMVC
• การแก้ไขความเข้ากันได้ของ PHP 8
• ข้อผิดพลาดอื่น ๆ

เวอร์ชัน 1.3.1-2023-03-27

• SQL Builder: ใช้ Tablename เป็นนามแฝงเริ่มต้น
• เพิ่มคำสั่งโยกย้าย/รอ
• เลื่อนการเชื่อมต่อการเชื่อมต่อ
• การแสดงผลภาษาท้องถิ่น

เวอร์ชัน 1.3-2022-12-03

• ปัญหาการทำธุรกรรมการย้ายถิ่น SQL
• ความเข้ากันได้ของ MySQL 8.0 รักษาความเข้ากันได้ 5.7
• แอพ: ดูเส้นทางที่ได้รับการแก้ไขแล้ว
• ตรวจสอบการกำหนดค่า CLI
• AppHelper :: Waitfor ()
• การแก้ไขการทดสอบหน่วย
• มีการรวมแอปพลิเคชั่นทดสอบ Dockerized พร้อมคู่มือการทดสอบ
• Docker: กำลังรอการเริ่มต้นฐานข้อมูลคอนเทนเนอร์ (วิธีการง่าย ๆ )
• เพิ่มเอกสารขั้นตอนแรก

เวอร์ชัน 1.2.1-2022-10-02

• twig/twig <2.15.3 การแก้ไขช่องโหว่ (posposer.lock)
• AuthManager :: ActionLogin () เพิ่มเพื่อแก้ไขปัญหาการส่งคืนการเข้าสู่ระบบเริ่มต้น

เวอร์ชัน 1.2-2022-09-20

• Bugfixes, PHPDOC FIXES
• ลายเซ็น LinkButton มีการเปลี่ยนแปลง
• การเชื่อมต่อ :: Connect กลับมาแล้ว
• วิธีการเชื่อมต่อข้อมูล (getTables () ฯลฯ )
• วิธีการ mysqlconnection dropxxx
• คำสั่งโยกย้าย/รีเซ็ต
• การทดสอบหน่วยแอพทดสอบ (ร่าง)
• showexception ข้อความก่อนหน้าแก้ไขแล้ว
• การตรวจสอบคีย์หลักรุ่น
• Samlauth: อัปเดตบันทึกผู้ใช้เท่านั้นที่เข้าสู่ระบบ
• ลบการสร้างไฟล์เวอร์ชัน

เวอร์ชัน 1.1-2022-08-30

• การปรับปรุงรีจิสทรีสินทรัพย์ (คอนโทรลเลอร์ :: registerAssets () ฯลฯ )
• เพิ่ม html :: img ()
• เซสชัน, คำขอ, คลาส FileUpload
• การแปล (แอพ :: l (), แอพ :: $ locale, l10n, l10nfile ฯลฯ )
• แอพ: พารามิเตอร์เค้าโครงเริ่มต้น
• RENDER BUGFIXES
• samlauth :: get () แก้ไข

อัพเกรดบันทึกสำหรับเวอร์ชัน 1.1

• แอพ :: การโทรจะต้องถูกแทนที่ด้วยแอป :: linkAssetFile () การโทร (ใช้อาร์กิวเมนต์เดียวกัน)