เริ่มต้นใช้งาน NextPDF

ภาพรวมโดยสรุป

NextPDF คือเอนจิน PHP 8.4 สำหรับสร้างและตรวจสอบเอกสาร Portable Document Format (PDF) 2.0 ซึ่งเป็นรูปแบบไฟล์ที่กำหนดโดย ISO 32000-2 คุณสร้างเอกสารผ่าน application programming interface (API) แบบมีไทป์พร้อมรูปแบบการเขียนต่อเนื่องที่ลื่นไหล เรนเดอร์ Hypertext Markup Language (HTML) และ Cascading Style Sheets (CSS) ให้เป็นหน้าเอกสาร ลงลายเซ็นและจัดเก็บผลลัพธ์ถาวร และอ่านเนื้อหาที่มีโครงสร้างกลับออกมาได้ ทั้งหมดนี้ทำงานใน PHP และเส้นทางหลักไม่จำเป็นต้องพึ่งพาไบนารีภายนอก

โปรเจกต์นี้เผยแพร่เป็นดิสทริบิวชันสี่แบบ ครอบคลุมทั้งแบบ open source software (OSS) และระดับที่มีใบอนุญาต ทุกแบบใช้เอนจินเดียวกันเป็นพื้นฐาน ดังนั้นให้ติดตั้งแบบที่เหมาะกับวิธีการทำงานของคุณ

ดิสทริบิวชัน	แพ็กเกจ	ติดตั้งเมื่อ
NextPDF core (OSS)	`nextpdf/core`	คุณเขียน PHP และต้องการเข้าถึงเอนจินโดยตรง ไม่ว่าจะใช้ร่วมกับเฟรมเวิร์กหรือใช้แบบลำพัง
NextPDF Server (OSS)	`nextpdf/server`	คุณต้องการบริการแบบสแตนด์อะโลนที่เปิดให้เข้าถึงเอนจินผ่าน Model Context Protocol (MCP) Representational State Transfer (REST) และ gRPC
NextPDF Pro	`nextpdf/premium` (ระดับ Pro)	คุณต้องการการลงลายเซ็นดิจิทัล การจัดเก็บถาวรแบบ PDF/A หรือเอาต์พุตสำหรับใบแจ้งหนี้อิเล็กทรอนิกส์
NextPDF Enterprise	`nextpdf/premium` (ระดับ Enterprise)	คุณต้องการการลงลายเซ็นที่รองรับด้วยฮาร์ดแวร์ ลายเซ็นที่ผ่านการรับรอง และความครอบคลุมด้านการปฏิบัติตามข้อกำหนดอย่างครบถ้วน

NextPDF Pro และ NextPDF Enterprise เป็นระดับที่มีใบอนุญาตของแพ็กเกจ nextpdf/premium ตัวเดียวกัน เอนจินหลักทำงานเหมือนเดิมไม่ว่าจะติดตั้งแพ็กเกจนั้นหรือไม่ก็ตาม

ติดตั้งในบรรทัดเดียว

ในโปรเจกต์ PHP ทั่วไป ให้ติดตั้งเอนจินหลักด้วย Composer

composer require nextpdf/core

แพ็กเกจนี้เพียงแพ็กเกจเดียวสร้างและตรวจสอบไฟล์ PDF ได้โดยไม่ต้องตั้งค่าเพิ่มเติม ส่วนการผสานรวมเฟรมเวิร์ก ตัวเรนเดอร์ HTML เซิร์ฟเวอร์ และ Python software development kit (SDK) จะเพิ่มแพ็กเกจอีกหนึ่งแพ็กเกจขึ้นไปในแต่ละชั้น คู่มือการติดตั้ง แสดงรายการคำสั่งทุกคำสั่ง

เลือกเส้นทางของคุณ

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

ติดตั้ง เมทริกซ์การติดตั้งฉบับเต็ม: core การผสานรวมเฟรมเวิร์ก ตัวเรนเดอร์ HTML เซิร์ฟเวอร์ และ Python SDK

PDF ฉบับแรกของคุณ บทแนะนำสั้น ๆ ที่สร้างไฟล์ PDF จาก PHP จากนั้นเรนเดอร์ HTML เป็น PDF

เลือกเส้นทางของคุณ คู่มือช่วยตัดสินใจระหว่าง core เฟรมเวิร์ก และเซิร์ฟเวอร์ และควรใช้ตัวเรนเดอร์ HTML ตัวใด

การผสานรวม อะแดปเตอร์เฟรมเวิร์ก ตัวเรนเดอร์บนเบราว์เซอร์ บริการแบบเอดจ์ และแพ็กเกจสำหรับการย้ายระบบ

ขั้นตอนถัดไป

หลังจากสร้างเอกสารฉบับแรกแล้ว ให้ใช้เอกสารประกอบหลักทั้งสามส่วนนี้

คู่มือและการผสานรวม ใช้งานแพ็กเกจที่เหมาะกับเฟรมเวิร์ก ตัวเรนเดอร์ รันไทม์ หรือเป้าหมายการย้ายระบบของคุณ — Laravel Symfony CodeIgniter Artisan Cloudflare และ Gotenberg

การอ้างอิง API พื้นผิวของเอนจินที่ผ่านการตรวจสอบ: คลาส เมท็อด คีย์การกำหนดค่า และเมทริกซ์การรองรับ CSS

ตำราการใช้งาน สูตรที่เน้นเฉพาะงาน — เรนเดอร์ HTML เป็น PDF จัดสไตล์ด้วย CSS จัดวางตาราง และแบ่งหน้าสำหรับเนื้อหาที่ยาว

ทำไมจึงต้องมีเซิร์ฟเวอร์แยกต่างหาก

ติดตั้ง NextPDF Server เมื่อบริการที่ไม่ใช่ PHP เอเจนต์ หรือ รันไทม์อื่นจำเป็นต้องเรียกใช้เอนจินผ่านโปรโตคอลเครือข่าย แทนการลิงก์ไปยังไลบรารี Python SDK เป็น ไคลเอนต์แบบมีไทป์สำหรับเซิร์ฟเวอร์นั้น