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

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

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

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

หนึ่งตัวอย่าง หนึ่ง runtime

สูตรแต่ละรายการมุ่งเป้าไปที่ runtime หนึ่งเดียว สูตร PHP เรียกใช้ core engine ภายในกระบวนการ สูตร Connect เรียกใช้เครื่องมือผ่าน transport สูตร Integration เชื่อมต่อ NextPDF เข้ากับ framework หรือ renderer backend อ่านหน้าข้อกำหนดที่เกี่ยวข้องก่อนนำตัวอย่างไปปรับใช้

งานที่พบบ่อย

ข้ามไปยังหน้าของงานที่ต้องการได้ทันที:

• สร้าง PDF
• เรนเดอร์ HTML เป็น PDF
• ลงนาม PDF
• สร้าง PDF/A
• ผสานรวมกับ Laravel
• รันเป็น server
• ย้ายจากไลบรารีเดิม
• เลือก Pro หรือ Enterprise

สูตร 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 ต่างๆ