Grav - ตะขอเกี่ยวเหตุการณ์
ในบทนี้เราจะศึกษาเกี่ยวกับ Event Hooksใน Grav ในบทปลั๊กอินคุณจะเห็นตรรกะของปลั๊กอินรวมอยู่ในสองวิธี วิธีการคือonPluginsInitialized และ onPageInitialized; วิธีการเหล่านี้คล้ายกับขอเกี่ยวเหตุการณ์ หากต้องการทราบข้อมูลเพิ่มเติมและควบคุมพลังของปลั๊กอิน Grav คุณต้องตรวจสอบความพร้อมใช้งานของขอเกี่ยวเหตุการณ์ ตะขอเกี่ยวกับเหตุการณ์มีความสัมพันธ์โดยตรงกับ Grav ตั้งแต่ต้นจนจบ คุณต้องตระหนักถึงลำดับที่เรียกตะขอและสิ่งที่ใช้งานได้ในช่วงเวลาของการโทรเหล่านี้
ตารางต่อไปนี้แสดงรายละเอียด Grav หลัก event hooks ที่เปิดใช้งานในระหว่างการประมวลผลเพจ
| ซีเนียร์ | เหตุการณ์และคำอธิบาย |
|---|---|
| 1 | onFatalException คุณสามารถเริ่มกิจกรรมนี้ได้ทุกเมื่อหาก PHPให้ข้อยกเว้นร้ายแรง Problem ปลั๊กอินใช้สิ่งนี้เพื่อจัดการการแสดงรายการคำอธิบายทั้งหมดว่าเพราะเหตุใด Grav จึงส่งข้อผิดพลาดร้ายแรง |
| 2 | onPluginsInitialized นี่เป็นเหตุการณ์ปลั๊กอินแรกที่สามารถใช้ได้ใน Grav มีการแนะนำวัตถุต่อไปนี้ตามที่กล่าวไว้ด้านล่าง -
|
| 3 | onAssetsInitialized สิ่งนี้ระบุว่าไฟล์ assets มีการโหลดผู้จัดการและพร้อมใช้งานและจัดการ |
| 4 | onPageNotFound หากคุณพบหน้าที่ไม่คาดคิดคุณสามารถปิดกิจกรรมนี้ได้ ปัจจุบันปลั๊กอินข้อผิดพลาดถูกใช้เพื่อระบุไฟล์404 error หน้า. |
| 5 | onPageInitialized สิ่งนี้ระบุหน้าที่ร้องขอโดย URL ซึ่งโหลดลงในวัตถุหน้า |
| 6 | onOutputGenerated สิ่งนี้ระบุกระบวนการเอาต์พุตโดย Twig templatingเครื่องยนต์. ปัจจุบันเป็นเพียงสตริงของHTML. |
| 7 | onOutputRendered นี่คือกระบวนการเอาต์พุตซึ่งถูกส่งไปยังจอแสดงผล |
| 8 | onShutdown นี่เป็นเหตุการณ์ใหม่และทรงพลังมากที่ช่วยให้คุณสามารถดำเนินการต่างๆ เสร็จแล้วหลังจากที่ Grav มีcompleted processingและการเชื่อมต่อกับไคลเอนต์ถูกปิด การดำเนินการส่วนบุคคลนี้ไม่จำเป็นต้องมีการโต้ตอบใด ๆ กับผู้ใช้ผลลัพธ์อาจส่งผลต่อประสิทธิภาพ รวมถึงการติดตามผู้ใช้และการประมวลผลงาน |
| 9 | onBeforeDownload นี่คือเหตุการณ์ใหม่ที่ passesลงในวัตถุเหตุการณ์ที่มีไฟล์ อนุญาตให้ผู้ใช้ทำการบันทึกอนุญาตและละเว้นสิทธิ์ในการดาวน์โหลดไฟล์ดังกล่าว |
Twig Event Hooks
Twig มีคอลเลกชันของตะขอเกี่ยวเหตุการณ์ที่จะใช้ตามที่ระบุไว้ด้านล่าง
| ซีเนียร์ | เหตุการณ์และคำอธิบาย |
|---|---|
| 1 | onTwigTemplatePaths ตำแหน่งฐานของพา ธ เทมเพลตถูกตั้งค่าบนไฟล์ Twig object. เหตุการณ์นี้ใช้เพื่อเพิ่มตำแหน่งที่ตั้งอื่น ๆ ที่ Twig จะค้นหาเส้นทางเทมเพลต |
| 2 | onTwiglnitialized มัน initialize เครื่องยนต์ Twig templating |
| 3 | onTwigExtensions โดยระบุว่าส่วนขยายของ core twig พร้อมใช้งาน ขอเกี่ยวเหตุการณ์นี้ช่วยให้คุณสามารถเพิ่มส่วนขยาย Twig ของคุณเองได้ |
| 4 | onTwigPageVariables กระบวนการทวิกนี้อนุญาตให้คุณใช้เพจโดยตรงกล่าวคือคุณสามารถค้นหาได้ process:twig:truในหน้าของส่วนหัว YAML ที่นี่คุณสามารถเพิ่มตัวแปรใด ๆ ลงใน Twig และควรเข้าถึง twig ในระหว่างขั้นตอนนี้ |
| 5 | onTwigSiteVariables ในกระบวนการนี้คุณจะเห็นเทมเพลตไซต์แบบเต็มใน order wiseโดยวิธีทวิก นอกจากนี้คุณสามารถเพิ่มตัวแปรใด ๆ ให้กับ Twig ได้ในระหว่างกระบวนการนี้ |
ตะขอเกี่ยวเหตุการณ์คอลเลกชัน
ตารางต่อไปนี้แสดงรายการเหตุการณ์ของคอลเลกชัน
| ซีเนียร์ | เหตุการณ์และคำอธิบาย |
|---|---|
| 1 | onCollectionProcessed ในส่วนนี้เมื่อกระบวนการเสร็จสมบูรณ์คุณสามารถทำได้ control คอลเลกชัน |
Page Event Hooks
ตารางต่อไปนี้แสดงคอลเล็กชันของ page event hooks
| ซีเนียร์ | เหตุการณ์และคำอธิบาย |
|---|---|
| 1 | onBuildPagesInitialized เหตุการณ์นี้มีประโยชน์สำหรับปลั๊กอินเพื่อควบคุมเนื้อหาและแคชผลลัพธ์ เมื่อเปิดใช้งานกิจกรรมนี้เพจจะถูกรีไซเคิล สิ่งนี้เกิดขึ้นเมื่อมีแคชexpired หรือความต้องการ refreshing. |
| 2 | onBlueprintCreated เหตุการณ์นี้ช่วยในการประมวลผลและจัดการแบบฟอร์ม |
| 3 | onPageContentRaw ในกระบวนการนี้เมื่อพบเพจ headers ได้รับการแก้ไข แต่ contentจะไม่ได้รับการแก้ไข คุณจะเห็นทุกหน้าถูกยิงในระบบ Grav หากคุณล้างแคชหรือล้างแคชเหตุการณ์นี้จะเกิดขึ้น |
| 4 | onPageProcessed เมื่อหน้าเป็น testedและแก้ไขทุกหน้าจะถูกปิดในระบบ Grav ประสิทธิภาพไม่สำคัญในกรณีนี้เนื่องจากจะไม่เล่นบนหน้าที่แคชไว้ |
| 5 | onPageContentProcessed คุณสามารถเห็นเหตุการณ์นี้ถูกปิดเมื่อเทคนิค content () ของเพจได้แก้ไขเนื้อหาของเพจแล้ว เหตุการณ์นี้มีประโยชน์ในกรณีที่คุณต้องการดำเนินการกับเนื้อหาหลังการแก้ไข แต่ตรวจสอบให้แน่ใจว่าได้ผลลัพธ์cached. |
| 6 | onFolderProcessed ครั้งเดียว folderได้รับการทดสอบและแก้ไขทุกโฟลเดอร์จะถูกปิดในระบบ Grav ประสิทธิภาพไม่สำคัญในกรณีนี้เนื่องจากจะไม่เล่นบนหน้าที่แคชไว้ |