ดาวน์โหลด php monty - php monty Source Source Download

php monty

หมวดหมู่อื่นๆ

v1.0.0

ดาวน์โหลด

มอนตี้

กรอบคล้าย Sinatra มุ่งเน้นไปที่การตอบสนองและความน่าเชื่อถือที่รวดเร็ว

การตั้งค่าตัวอย่าง

 $ composer require troublete/monty

 <?php
require_once ' path/to/vendor/autoload.php ' ;

$ application = new  Monty  Application ();

$ application -> get (
    ' /request[/{someId}] ' ,
    function (  Monty  Request $ req ,  Monty  Response $ res , $ someId ) {
        
        // do some awesome stuff
        
        return new  Symfony  Component  HttpFoundation  JsonResponse ([]);
    }
);

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

การแยกวิเคราะห์เส้นทางขึ้นอยู่กับแพ็คเกจ Fastroute ที่สร้างขึ้นเป็น @nikic ดังนั้นส่วนใหญ่ควรเป็นไปได้ที่จะกำหนดเส้นทางตามที่ระบุโดย Fastroute การจับคู่เส้นทางจะทำผ่าน PCRE โดยมีการตั้งค่าตัวคั่นเป็น @ ดังนั้นโปรดทราบเมื่อตั้งค่าพารามิเตอร์ Regex ที่กำหนดไว้ตรงกับ @ คำจำกัดความเส้นทางอนุญาตให้ชิ้นส่วนตัวแปรในตอนท้ายของคำจำกัดความที่ทำเครื่องหมายด้วย [] เนื่องจากเป็นไปได้การจับคู่จะลองใช้การแสดงออกปกติหลายครั้งตามลำดับความซับซ้อนของลูกหลานและจะกลับมาในการจับคู่รูปแบบแรก

การกำหนดเส้นทางที่ถูกต้อง

 /search/{searchId} => routing with parameter
/search/{searchId:d+} => routing with parameter with defined regex
/search[/{searchId}] => routing with optional parameter
/search/index[es] => routing with optional part

การกำหนดเส้นทางไม่ถูกต้อง

 /search/index[es]/{searchId} => optional chunk in the middle

ขอจัดการ

คำจำกัดความการจัดการจะถูกประมวลผลตามลำดับของการลงทะเบียนทันทีที่การแข่งขันหนึ่งรายการกับคำขอที่ได้รับมันจะส่งกลับและปิดกระบวนการ

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

ตัวจัดการในคำจำกัดความเป็นอาร์เรย์ของ callable และจะดำเนินการแบบซิงโครนัสตามลำดับในการจับคู่คำจำกัดความ Middlewares ที่ลงทะเบียนเพื่อทำงานก่อนหรือหลังจะถูกรวมเข้ากับ "Call Stack" นี้

หากวัตถุตอบกลับถูกส่งคืนในตัวจัดการมันจะถูกตีความว่าเป็นการตอบสนองของกระบวนการและไม่สามารถรีเซ็ตได้ (แต่แก้ไข)

แอปพลิเคชัน

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

นอกเหนือจากวิธีการใช้งานแล้วยังมีอินเทอร์เฟซของวิธีการนามแฝงเพื่อให้รหัสการเขียนของคุณเข้าใจและเพรียวบางมากขึ้น

วิธีการ

$ app-> handle ($ methods, $ route, ... $ handlers)

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

ข้อโต้แย้ง

การโต้แย้ง	พิมพ์	คำอธิบาย
$ วิธี	สตริง []	การรวบรวมวิธีการขอในตัวพิมพ์ใหญ่
$ เส้นทาง	สาย	เส้นทางที่ลงทะเบียนตัวจัดการ
... $ handlers	เรียกได้ []	คอลเลกชันของตัวจัดการที่จะดำเนินการ

ตัวอย่าง

 // ...
$ app -> handle (
    [ ' GET ' ], 
    ' /index ' , 
    function ( $ req , $ res ) { /*...*/ }, 
    function ( $ req , $ res ) { /*...*/ }, 
    function ( $ req , $ res ) { /*...*/ }
    // ...
);
// ...

นามแฝง

วิธี	คำอธิบาย
ทั้งหมด ($ route, ... $ handlers)	วิธีนามแฝงซึ่งจะตอบสนองต่อวิธีการร้องขอทั้งหมด
Get ($ Route, ... $ handlers)	วิธีนามแฝงซึ่งจะตอบสนองต่อการ ร้องขอ
โพสต์ ($ เส้นทาง, ... $ handlers)	วิธีนามแฝงซึ่งจะตอบสนองต่อ การโพสต์ คำขอ
Head ($ Route, ... $ handlers)	วิธีนามแฝงซึ่งจะตอบสนองต่อการร้องขอ ส่วนหัว
ตัวเลือก ($ route, ... $ handlers)	วิธีนามแฝงซึ่งจะตอบสนองต่อคำขอ ตัวเลือก
Patch ($ Route, ... $ handlers)	วิธีนามแฝงซึ่งจะตอบสนองต่อคำขอ แพตช์
Put ($ route, ... $ handlers)	วิธีนามแฝงซึ่งจะตอบสนองต่อการ ร้องขอ
DELETE ($ ROUTE, ... $ handlers)	วิธีนามแฝงซึ่งจะตอบสนองต่อ การลบ คำขอ

$ app-> middleware ($ วาง, ... $ handlers): monty application

วิธีนี้ลงทะเบียนตัวจัดการเพิ่มเติมซึ่งจะดำเนินการโดยไม่คำนึงถึงวิธีการร้องขอ

ข้อโต้แย้ง

การโต้แย้ง	พิมพ์	คำอธิบาย
$ วาง	จำนวนเต็ม	ตำแหน่ง Lifecycle ของคำขอ (แอปพลิเคชัน :: precend - ก่อนหน้าแอปพลิเคชัน :: ผนวก - หลังจาก) เมื่อควรดำเนินการตัวจัดการ
... $ handlers	เรียกได้ []	คอลเลกชันของตัวจัดการที่จะดำเนินการ

ตัวอย่าง

 // ...
$ app -> middleware (
     Monty Application:: PREPEND ,
    function ( $ req , $ res ) { /*...*/ },
    function ( $ req , $ res ) { /*...*/ },
    function ( $ req , $ res ) { /*...*/ }
    // ...
);
// ...

นามแฝง

วิธี	คำอธิบาย
ก่อน (... $ handlers)	วิธีนามแฝงซึ่งจะเพิ่มตัวจัดการคำขอดำเนินการ ก่อน การจัดการคำขอจริง
หลังจาก (... $ handlers)	วิธีนามแฝงซึ่งจะเพิ่มตัวจัดการคำขอที่ดำเนินการ หลังจาก การจัดการคำขอจริง

$ app-> getRequest (): monty Request

วิธีนี้ดึงวัตถุคำขอปัจจุบัน

$ app-> getResponse () :: monty response

วิธีนี้ดึงวัตถุตอบสนองปัจจุบัน

ขอ

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

วิธีการ

$ req-> clientip (): สตริง

วิธีการดึงข้อมูลคำขอ IP

$ req-> contentType (): สตริง

วิธีการดึงค่าส่วนหัวประเภทเนื้อหาที่ร้องขอ

$ req-> files (): symfony component httpfoundation filebag

วิธีการดึงพารามิเตอร์ $ _files

$ req-> get (... $ พารามิเตอร์)

วิธีนี้สามารถใช้เพื่อดึงคุณสมบัติหรือบริการที่ตั้งค่าไปยังคำขอ

ข้อโต้แย้ง

การโต้แย้ง	พิมพ์	คำอธิบาย
... $ พารามิเตอร์	ผสมกัน	การรวบรวมพารามิเตอร์ผ่านไปนานถึงวิธีการตั้งค่า

ตัวอย่าง

 // ...
$ request -> get ( ' logger ' , new SomeDefault ());
$ request -> get ( ' property ' , ' some default value ' );
// ...

$ req-> getRawRequest (): symfony Component httpfoundation Request

วิธีการดึงคำขอดิบที่ฝังอยู่ในวัตถุ Monty Request

$ req-> httphost (): สตริง

วิธีการดึงโฮสต์ HTTP รวมถึงโปรโตคอล

$ req-> ismethod ($ method): บูลีน

วิธีการตรวจสอบว่าวิธีการร้องขอเป็นค่าเฉพาะหรือไม่

ข้อโต้แย้ง

การโต้แย้ง	พิมพ์	คำอธิบาย
$ วิธี	สาย	วิธีการขอตรวจสอบ

$ req-> issecure (): บูลีน

วิธีการตรวจสอบว่าคำขอที่ส่งมีความปลอดภัยหรือไม่ (HTTPS/SSL)

$ req-> path (): สตริง

วิธีการดึงเส้นทางคำขอ

$ req-> previoutreturn (): ผสม

วิธีการดึงค่าคืนสินค้าของตัวจัดการก่อนหน้าในสแต็ก

$ req-> query (): symfony component httpfoundation parameterbag

วิธีการดึงพารามิเตอร์ $ _get

$ req-> requestMethod (): สตริง

วิธีการดึงวิธีการร้องขอ

$ req-> request (): symfony component httpfoundation parameterbag

วิธีการดึงพารามิเตอร์ $ _post

$ req-> routeparameters (): symfony component httpfoundation parameterbag

วิธีการดึงค่าพารามิเตอร์เส้นทางตรงกับอินสแตนซ์ตัวจัดการเส้นทาง

$ req-> set (... $ พารามิเตอร์): monty Request

วิธีนี้สามารถใช้เพื่อเพิ่มอินสแตนซ์คลาสหรือคุณสมบัติลงในคำขอที่สามารถเข้าถึงได้ตามสแต็กการโทร โดยปกติวิธีการใช้เวลาอย่างน้อยสองพารามิเตอร์ ID ของคุณสมบัติ/บริการเป็นสตริงและอันดับที่สองเป็นค่าสเกลาร์หรือวัตถุ

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

ข้อโต้แย้ง

การโต้แย้ง	พิมพ์	คำอธิบาย
... $ พารามิเตอร์	ผสมกัน	การรวบรวมพารามิเตอร์ผ่านไปนานถึงวิธีการตั้งค่า

ตัวอย่าง

 // ...
$ request -> set ( ' logger ' , new SomeLogger ()); // valid
$ request -> set ( ' property ' , ' some value ' ); // valid

$ request -> set ( ' not_possible ' , []); // invalid
// ...

$ req-> setPreviousreturn ($ value): Monty Request

วิธีการตั้งค่าตัวจัดการก่อนหน้า

ข้อโต้แย้ง

การโต้แย้ง	พิมพ์	คำอธิบาย
$ มูลค่า	ผสมกัน	ค่าส่งคืนของตัวจัดการก่อนหน้า

$ req-> updaterOuteParams ($ params): monty Request

วิธีการอัปเดตพารามิเตอร์เส้นทางที่ตั้งค่าเป็นคำขอ

ข้อโต้แย้ง

การโต้แย้ง	พิมพ์	คำอธิบาย
$ params	อาร์เรย์	พารามิเตอร์เส้นทางที่จะตั้งค่า

การตอบสนอง

โดยทั่วไปวัตถุตอบสนองจะถือว่าเป็นตัวแก้ไขตัวเอง - หมายความว่าควรจัดการกับวิธีการตอบสนองที่กำหนดไว้ควรแสดงในการตอบสนองของแอปพลิเคชัน คุณสามารถใช้วัตถุการตอบสนองส่วนประกอบ Symfony HTTP หรือกำหนดวัตถุของตัวเองซึ่ง จำเป็น ต้องใช้ monty responseInterface