เลือกเส้นทางการใช้งาน

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

NextPDF มีวิธีเริ่มต้นใช้งานได้หลายแบบ ตัวเลือกที่เหมาะสมขึ้นอยู่กับตำแหน่งที่โค้ดของคุณทำงาน และชนิดของเอาต์พุต Portable Document Format (PDF) ที่ต้องการ ใช้หน้านี้เพื่อช่วยตัดสินใจสามเรื่อง ได้แก่ ควรติดตั้งดิสทริบิวชันใด ควรใช้ตัวเรนเดอร์ Hypertext Markup Language (HTML) ตัวใด และเวิร์กโหลดต้องใช้ Pro หรือ Enterprise เมื่อใด

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

เลือกดิสทริบิวชัน

เริ่มจากวิธีที่แอปพลิเคชันของคุณเรียกใช้เอนจิน แล้วใช้แถวแรกที่ตรงกับสถานการณ์ของคุณ

สถานการณ์ของคุณ	ติดตั้ง	เหตุผล
โปรเจกต์ PHP ทั่วไป ไลบรารี หรือเครื่องมือ command-line interface (CLI)	NextPDF core (nextpdf/core)	มีเฉพาะเอนจิน เอนจินนี้ไม่ตั้งสมมติฐานเกี่ยวกับเฟรมเวิร์ก และไม่รันบริการใด ๆ
แอปพลิเคชัน Laravel, Symfony หรือ CodeIgniter	การผสานรวมเฟรมเวิร์กที่ตรงกัน	คุณจะได้รับ container bindings, response helpers และ queue jobs เพิ่มเติมจาก core
บริการที่ไม่ใช่ PHP เอเจนต์ หรือรันไทม์อื่นที่ต้องเรียกใช้เอนจินผ่านเครือข่าย	NextPDF Server (nextpdf/server)	บริการเดียวทำให้เอนจินใช้งานได้ผ่าน Model Context Protocol (MCP), REST และ gRPC
โค้ด Python ที่ต้องการไฟล์ PDF จาก NextPDF Server	ชุดพัฒนาซอฟต์แวร์ Python (SDK) (pip install nextpdf)	ไคลเอนต์ที่กำหนดชนิดข้อมูลไว้สำหรับเซิร์ฟเวอร์ที่กำลังทำงานอยู่ ไคลเอนต์นี้ไม่ได้ฝังเอนจินไว้ภายใน

มีสองประเด็นที่มักถูกมองข้าม

• การผสานรวมเฟรมเวิร์ก รวม core ไว้แล้ว คุณไม่ต้องติดตั้งทั้งสองอย่างแยกกัน อะแดปเตอร์จะประกาศและจัดการการอ้างอิง nextpdf/core ให้คุณโดยอัตโนมัติ
• Python SDK เป็น ไคลเอนต์ ไม่ใช่เอนจิน โดยเชื่อมต่อกับเอนด์พอยต์ของ NextPDF Server การสร้าง PDF จะเกิดขึ้นใน PHP บนเซิร์ฟเวอร์

ไลบรารีหรือบริการ?

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

เลือกตัวเรนเดอร์ HTML

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

ตัวเรนเดอร์	แพ็กเกจ	ตำแหน่งที่ทำงาน	เลือกใช้เมื่อ
ในตัว writeHtml()	nextpdf/core	ภายในโพรเซสเดียวกัน ใช้ PHP ล้วน	คุณต้องการใช้ชุดย่อยของ HTML และ Cascading Style Sheets (CSS) ที่รองรับ โดยไม่ต้องใช้เบราว์เซอร์และไม่ต้องเรียกผ่านเครือข่าย
Artisan	nextpdf/artisan	Headless Chrome บนโฮสต์	คุณต้องการเค้าโครง Chrome เต็มรูปแบบ — flexbox, grid, ตัวเลือกที่ซับซ้อน, เว็บฟอนต์ — พร้อมข้อความที่เลือกได้
Cloudflare	nextpdf/cloudflare	Cloudflare Browser Rendering ที่ขอบเครือข่าย	การเรนเดอร์ควรเกิดที่ขอบเครือข่าย หรือคุณไม่ต้องการให้มีโพรเซสเบราว์เซอร์ทำงานบนโฮสต์ของคุณเอง
Gotenberg	nextpdf/gotenberg	บริการ Gotenberg ที่คุณดูแลเอง	คุณต้องการแปลงเอกสารสำนักงาน (DOCX, XLSX) หรือ HTML ผ่านการติดตั้ง Gotenberg ที่มีอยู่เดิม

วิธีใช้ตารางนี้

• เริ่มต้นด้วย ไปป์ไลน์ในตัว เส้นทางนี้เร็วที่สุดและไม่มีการพึ่งพาภายนอก ก่อนจะพึ่งพาคุณสมบัติใด ให้ตรวจสอบ เมทริกซ์การรองรับ CSS ก่อน
• ใช้ Artisan เมื่อเค้าโครงเกินขอบเขตของชุดย่อยที่รองรับ และควรเรนเดอร์บนโครงสร้างพื้นฐานของคุณ วิธีนี้จะเริ่มโพรเซส Chrome ดังนั้นควรวางแผนสำหรับวงจรชีวิตของโพรเซสนั้น
• ใช้ Cloudflare เมื่อคุณต้องการความเที่ยงตรงระดับเบราว์เซอร์เช่นเดียวกัน และต้องการให้เรนเดอร์ที่ขอบเครือข่ายแทนการใช้โพรเซสเบราว์เซอร์ในเครื่อง
• ใช้ Gotenberg สำหรับการแปลงเอกสารสำนักงาน หรือเมื่อคุณรัน Gotenberg อยู่แล้วและต้องการให้ NextPDF เป็นผู้ควบคุมการทำงาน

ตัวเรนเดอร์ขยายพื้นผิวการคุกคาม

โดยค่าเริ่มต้น ไปป์ไลน์ในตัวจะไม่รันสคริปต์ใด ๆ และไม่ดึงทรัพยากรจากระยะไกล ส่วน Artisan, Cloudflare และ Gotenberg ต่างเรนเดอร์ผ่านเบราว์เซอร์ หรือบริการเครือข่าย ให้ถือว่า HTML เป็นข้อมูลที่ไม่น่าเชื่อถือ และอ่านหน้า security-and-operations ของแต่ละแพ็กเกจก่อนส่งอินพุตที่ได้รับอิทธิพลจากผู้ใช้

เมื่อใดที่คุณต้องใช้ Pro หรือ Enterprise

เอนจิน core สร้าง เรนเดอร์ และตรวจสอบ PDF ได้โดยไม่มีค่าใช้จ่ายและไม่ต้องใช้ลิขสิทธิ์ NextPDF Pro และ NextPDF Enterprise เป็นระดับลิขสิทธิ์สองระดับของแพ็กเกจ nextpdf/premium การติดตั้งแพ็กเกจนี้จะเพิ่มความสามารถโดยไม่เปลี่ยนแปลง API ของ core

สิ่งที่คุณต้องการ	ระดับ	ความสามารถ
ลงลายเซ็นดิจิทัลบน PDF ด้วยเบสไลน์ PDF Advanced Electronic Signatures (PAdES)	Pro	การใช้งานการลงนามด้วยคีย์แบบซอฟต์แวร์
สร้างเอาต์พุต PDF/A สำหรับการจัดเก็บถาวร	Pro	การปฏิบัติตามมาตรฐาน PDF/A และโปรไฟล์การจัดเก็บถาวร
ฝังใบแจ้งหนี้อิเล็กทรอนิกส์ (Factur-X / ZUGFeRD)	Pro	การใช้งานสัญญา e-invoice
ลงนามด้วย hardware security module (HSM)	Enterprise	การดำเนินการกับคีย์ที่มีฮาร์ดแวร์รองรับ
ออกลายเซ็นอิเล็กทรอนิกส์แบบรับรอง	Enterprise	เวิร์กโฟลว์ลายเซ็นแบบรับรองและการปฏิบัติตามข้อกำหนดครบถ้วน

มีสองกฎที่ช่วยให้ตัดสินใจได้ตรงไปตรงมา

• หากเอาต์พุตของคุณเป็น PDF ที่ไม่ได้ลงนามและไม่ได้ใช้สำหรับการจัดเก็บถาวร core ก็เพียงพอแล้ว คุณไม่จำเป็นต้องมีลิขสิทธิ์
• เมื่อคุณติดตั้ง nextpdf/premium การผสานรวมเฟรมเวิร์กและเซิร์ฟเวอร์จะ ตรวจพบโดยอัตโนมัติ โดยจะเปิดใช้ความสามารถเพิ่มเติมผ่าน container keys และแคตตาล็อกเครื่องมือชุดเดิม แอปพลิเคชันของคุณไม่จำเป็นต้องเปลี่ยนโค้ดเพื่อใช้งาน

สรุปการตัดสินใจ

ดิสทริบิวชัน

PHP ทั่วไป → core แอปที่ใช้เฟรมเวิร์ก → การผสานรวม ที่ตรงกัน ขอบเขตเครือข่าย → เซิร์ฟเวอร์ ไคลเอนต์ Python → Python SDK

ตัวเรนเดอร์ HTML

ชุดย่อยที่รองรับ ไม่มีการพึ่งพาภายนอก → writeHtml() ความเที่ยงตรง ระดับเบราว์เซอร์บนโฮสต์ของคุณ → Artisan ที่ขอบเครือข่าย → Cloudflare การแปลงเอกสารสำนักงาน → Gotenberg

ระดับลิขสิทธิ์

PDF ที่ไม่ได้ลงนาม → core การลงนาม, PDF/A, e-invoice → Pro HSM หรือลายเซ็นแบบรับรอง → Enterprise

ยังไม่แน่ใจ?

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

ดูเพิ่มเติม

ติดตั้ง NextPDF คำสั่งที่แน่นอนสำหรับทุกดิสทริบิวชันและทุกตัวเรนเดอร์

PDF แรกของคุณ สร้าง PDF จาก PHP และเรนเดอร์ HTML เป็น PDF

การผสานรวม แผนผังส่วนขยายฉบับเต็ม คู่มือการเลือก และคู่มือแยกตามแพ็กเกจ

เชื่อมต่อ (เซิร์ฟเวอร์) รันเอนจินเป็นบริการเครือข่ายผ่าน MCP, REST และ gRPC