Cookbook (สูตรการใช้งาน)

ภาพรวมโดยย่อ

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

หากต้องการเข้าใจ เหตุผลที่ engine ทำงานในลักษณะหนึ่ง ให้อ่าน Guides แทน สำหรับ application programming interface (API) ที่ผ่านการตรวจสอบแล้ว ให้อ่าน Reference

สูตร PHP

สูตร PHP เรียกใช้ core engine โดยตรงภายในกระบวนการ สูตรแต่ละรายการเริ่มต้นด้วย composer require nextpdf/core จากนั้นใช้ public API เพื่อสร้าง ลงนาม ตรวจสอบ หรือแปลงเอกสาร รวมถึง Document::createStandalone() และ writeHtml()

สูตร PHP แผนผังของทุกสูตรที่เป็น PHP-native: เรนเดอร์ HTML เป็น PDF, จัดวางตาราง, ฝังและทำ subset ฟอนต์, เข้ารหัสลับด้วย AES-256, ลงนามด้วย PAdES, สร้าง PDF/A-4 และ tagged PDF/UA-2, แยกข้อความ และตรวจสอบไฟล์ที่มีอยู่

สูตร Connect

สูตร Connect เรียกใช้ NextPDF ผ่าน server tool registry บน Model Context Protocol (MCP), Representational State Transfer (REST) หรือ gRPC การเรียกใช้เครื่องมือรูปแบบเดียวกันทำงานได้กับ transport ทั้งสามแบบ และยังคงมีผลหลัง human-in-the-loop confirmation gate

สูตร Connect สูตรที่ไม่ขึ้นกับ transport สำหรับ NextPDF Connect server: hello world, ตาราง HTML, การฝังภาพ, ลายเซ็นดิจิทัล, การตรวจสอบ accessibility และ compliance, การลบข้อมูล (redaction), การวิเคราะห์เชิงนิติวิทยาศาสตร์ และ observability ด้วย OpenTelemetry

สูตร Integration

สูตร Integration แสดงวิธีเชื่อมต่อ NextPDF เข้ากับ application framework หรือมอบหมายงานเรนเดอร์ให้ backend ภายนอก สูตรเหล่านี้ครอบคลุม framework adapters, renderer bridges และเส้นทางการย้าย (migration path) จากไลบรารีเดิม

สูตร Integration สูตรสำหรับแพ็กเกจในระบบนิเวศ: เลือก integration, คืนค่า PDF จาก framework controller, จัดคิวการสร้างใน background job, เรนเดอร์ HTML ด้วย Artisan, แปลงไฟล์ Office ด้วย Gotenberg, เรนเดอร์ที่ edge ด้วย Cloudflare และทำตามเส้นทางการย้าย (migration path) ของ TCPDF

ข้อกำหนดของสูตร

ทุกสูตรปฏิบัติตามสัญญาที่บันทึกไว้: ตัวอย่างที่มีซอร์สโค้ดรองรับ, reproducibility-profile front-matter, ขอบเขตความสอดคล้อง (conformance boundary) ที่ตรงไปตรงมา และ publish gate อ่านหน้าข้อกำหนดสำหรับตระกูลสูตรที่เกี่ยวข้องก่อนนำตัวอย่างไปปรับใช้

ข้อกำหนดของสูตร Integration สัญญาที่ทุกสูตร integration ที่รันได้ปฏิบัติตาม: ตัวอย่างที่มีซอร์สโค้ดรองรับ, reproducibility-profile front-matter และ publish gate

ข้อกำหนดของสูตร Connect สัญญาที่ทุกสูตร Connect ปฏิบัติตาม: การเรียกใช้เครื่องมือที่ไม่ขึ้นกับ transport, เครื่องมือที่ขึ้นกับ tier (tier-conditional), risk model และ confirmation gate และขอบเขตความสอดคล้อง (conformance boundary) ที่ตรงไปตรงมา

ดูเพิ่มเติม

Guides — เอกสารเชิงแนวคิดและเอกสารแบบ how-to
Reference — API ที่ผ่านการตรวจสอบแล้วและ support matrix สำหรับ Cascading Style Sheets (CSS)
Choose an integration — เมทริกซ์การตัดสินใจที่จับคู่กรณีการใช้งานกับ integration ต่างๆ