การติดตั้ง NextPDF

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

ติดตั้งดิสทริบิวชัน NextPDF ใดก็ได้ด้วยคำสั่งตัวจัดการแพ็กเกจเพียงคำสั่งเดียว ดิสทริบิวชันของ PHP ใช้ Composer ส่วน Python software development kit (SDK) ใช้ pip เลือกแท็บที่ตรงกับสิ่งที่คุณกำลังสร้าง เรียกใช้คำสั่ง แล้วตรวจสอบผลลัพธ์ที่ด้านล่างของหน้านี้

เอนจินเดียว แต่มีทางเข้าหลายทาง

เอนจินหลักคือ nextpdf/core การผสานรวมกับเฟรมเวิร์ก ตัวเรนเดอร์ Hypertext Markup Language (HTML) เซิร์ฟเวอร์ และไคลเอนต์ Python ต่างเพิ่ม แพ็กเกจอีกชั้นหนึ่ง แพ็กเกจเหล่านี้ไม่ได้แทนที่เอนจินหลัก แต่จะติดตั้งเอนจินหลักให้คุณ

ข้อกำหนด

NextPDF ออกแบบมาสำหรับรันไทม์สมัยใหม่เพียงชุดเดียว ข้อจำกัดเหล่านี้มาจากไฟล์ composer.json ของแพ็กเกจโดยตรง

ข้อกำหนดขณะทำงานของ NextPDF ที่อ่านจากไฟล์ composer.json ของแต่ละแพ็กเกจเอง

ข้อกำหนด	ข้อจำกัด	สถานะ	หมายเหตุ
PHP	>=8.4 <9.0	จำเป็น	Composer จะไม่ยอมติดตั้งบน PHP 8.3 หรือต่ำกว่า หรือบน PHP 9
Composer	2.x	จำเป็น	จำเป็นสำหรับการจัดการการอ้างอิงและการสร้าง autoloader
ext-mbstring	—	จำเป็น	การจัดการสตริงแบบหลายไบต์สำหรับการจัดวางข้อความ
ext-zlib	—	จำเป็น	การบีบอัดสตรีมสำหรับอ็อบเจกต์ Portable Document Format (PDF)
ext-intl	—	จำเป็น	บริการของ International Components for Unicode (ICU): ข้อความแบบสองทิศทาง การตัดบรรทัด และการจัดรูปแบบตามโลแคล
ext-gd	—	จำเป็น	การถอดรหัสและประมวลผลภาพแรสเตอร์สำหรับภาพที่ฝังอยู่
ext-curl	—	จำเป็น	การรับส่งข้อมูลผ่านเครือข่าย: การประทับเวลาแบบ RFC 3161 และการดึงแอสเซตจากระยะไกล การสร้างแบบออฟไลน์ไม่ได้เรียกใช้ส่วนนี้ แต่ Composer ก็ยังต้องการอยู่ดี
ext-openssl	—	จำเป็น	การเข้ารหัสลับสำหรับลายเซ็นดิจิทัล โครงสร้าง CMS และการเข้ารหัส
Chrome or Chromium	—	ไม่บังคับ	สำหรับตัวเรนเดอร์ Artisan (writeHtmlChrome()) เท่านั้น
Gotenberg service	—	ไม่บังคับ	สำหรับการแปลงไฟล์ office และ HTML ผ่าน Gotenberg เท่านั้น
Python	3.10+	ไม่บังคับ	สำหรับ Python software development kit (SDK) เท่านั้น

ext-mbstring และ ext-zlib มาพร้อมและเปิดใช้งานอยู่แล้วในบิลด์ของ PHP ส่วนใหญ่ ส่วน ext-intl ext-gd ext-curl และ ext-openssl แตกต่างกันไปตามดิสทริบิวชัน จึงควรตรวจสอบทั้งหกส่วนด้วย php -m ก่อนติดตั้ง การผสานรวมจะตรวจสอบส่วนขยายที่จำเป็นระหว่างการบูต และจะหยุดทำงานพร้อมข้อความที่ชัดเจนหากขาดส่วนใด

ติดตั้ง core

หากต้องการสร้างและตรวจสอบไฟล์ PDF จาก PHP คุณต้องใช้เอนจินหลักเท่านั้น

composer require nextpdf/core

คอมมิต composer.lock เพื่อให้เวิร์กเกอร์ทุกตัวที่นำไปใช้งานจริงใช้เอนจินเวอร์ชันเดียวกัน หลังการติดตั้ง ให้ไปต่อที่ PDF แรกของคุณ ได้

ติดตั้งการผสานรวมกับเฟรมเวิร์ก

ติดตั้งอะแดปเตอร์เฟรมเวิร์กหนึ่งตัวเพื่อให้ได้คอนเทนเนอร์ไบนดิง ตัวช่วยจัดการ response และคิวงาน อะแดปเตอร์แต่ละตัวประกาศ nextpdf/core และแก้ไขให้คุณเอง

Laravel

composer require nextpdf/laravel

Auto-discovery จะลงทะเบียน service provider และ facade Pdf จากนั้นเผยแพร่ไฟล์การกำหนดค่า:

php artisan vendor:publish --tag=nextpdf-config

ดูคู่มือการติดตั้ง Laravel และการเริ่มต้นใช้งานฉบับย่อ Laravel ประกอบได้

Symfony

composer require nextpdf/symfony

ในแอปพลิเคชัน Symfony Flex บันเดิลจะลงทะเบียนตัวเอง ในแอปพลิเคชันที่ไม่ใช่ Flex ให้เพิ่ม NextPDF\Symfony\NextPdfBundle ลงใน config/bundles.php ด้วยตนเอง ดูคู่มือการติดตั้ง Symfony ประกอบได้

CodeIgniter

composer require nextpdf/codeigniter

CodeIgniter 4 จะค้นพบคลาส Services และตัวช่วย pdf() โดยอัตโนมัติ จึงไม่จำเป็นต้องลงทะเบียนด้วยตนเอง ดูคู่มือการติดตั้ง CodeIgniter ประกอบได้

ติดตั้งตัวเรนเดอร์หรือบริการ

NextPDF เรนเดอร์ HTML เป็น PDF ได้สามวิธี ให้ติดตั้งตัวเลือกตามตำแหน่งที่คุณต้องการให้การเรนเดอร์ทำงาน ไม่มีตัวเลือกใดในนี้แทนที่ writeHtml() ซึ่งเป็นไปป์ไลน์ HTML แบบ pure-PHP ที่มีอยู่ในเอนจินหลัก

Artisan (Chrome)

composer require nextpdf/artisan

แพ็กเกจนี้เพิ่มการเรนเดอร์แบบ headless-Chrome ผ่าน Chrome DevTools Protocol (CDP) คุณยังต้องมีไบนารี Chrome หรือ Chromium ที่โฮสต์เข้าถึงได้ หลังการติดตั้ง ให้เรียก writeHtmlChrome() บนเอกสาร ดูการเริ่มต้นใช้งานฉบับย่อ Artisan ประกอบได้

Cloudflare

composer require nextpdf/cloudflare guzzlehttp/guzzle

การเรนเดอร์ทำงานผ่าน Cloudflare Browser Rendering ที่ edge บริดจ์นี้ขึ้นอยู่กับสัญญา PHP Standards Recommendation (PSR) เฉพาะ PSR-18 และ PSR-17 เท่านั้น คุณจึงต้องจัดหาไคลเอนต์ Hypertext Transfer Protocol (HTTP) ของคุณเอง (ในที่นี้แสดง Guzzle) ดูคู่มือการติดตั้ง Cloudflare ประกอบได้

Gotenberg

composer require nextpdf/gotenberg guzzlehttp/guzzle

แพ็กเกจนี้แปลงเอกสารสำนักงานและ HTML ผ่านบริการ Gotenberg คุณต้องจัดหาไคลเอนต์ PSR-18 และอินสแตนซ์ Gotenberg ที่เข้าถึงได้ ดูคู่มือการติดตั้ง Gotenberg ประกอบได้

ตัวเรนเดอร์เข้าถึงทรัพยากรภายนอก PHP

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

ติดตั้งเซิร์ฟเวอร์

NextPDF Server (เรียกอีกชื่อหนึ่งว่า Connect) เป็นบริการแบบสแตนด์อะโลนที่เปิดให้เข้าถึงเอนจินผ่าน Model Context Protocol (MCP), Representational State Transfer (REST) และ gRPC

composer require nextpdf/server

แพ็กเกจนี้เพิ่มจุดเข้าใช้งานแบบคอนโซลไปยัง vendor/bin/ ซึ่งรวมถึง vendor/bin/nextpdf-mcp (เซิร์ฟเวอร์ MCP แบบ stdio) และ vendor/bin/nextpdf-server (เซิร์ฟเวอร์ REST) ทรานสปอร์ต REST และ gRPC ยังต้องใช้ไบนารี RoadRunner:

./vendor/bin/rr get-binary

ดูคู่มือการติดตั้ง Connect และการเริ่มต้นใช้งานฉบับย่อ Connect ประกอบได้

ติดตั้ง Python SDK

Python SDK เป็นไคลเอนต์แบบมีชนิดข้อมูลสำหรับ NextPDF Server ที่กำลังทำงานอยู่ ติดตั้งจาก Python Package Index (PyPI):

pip install nextpdf

SDK ต้องใช้ Python 3.10 หรือใหม่กว่า และเอนด์พอยต์ NextPDF Server ที่เข้าถึงได้ ดูการเริ่มต้นใช้งานฉบับย่อ Python SDK ประกอบได้

ตรวจสอบการติดตั้ง

ยืนยันว่าแต่ละดิสทริบิวชันติดตั้งถูกต้องก่อนเริ่มเขียนโค้ด

Core / PHP

composer show nextpdf/core

บรรทัดที่แสดงเวอร์ชันเป็นการยืนยันว่าเอนจินติดตั้งแล้วและพร้อมใช้งานกับ autoloader

Laravel

php artisan package:discover --ansi

เอาต์พุตจะแสดง nextpdf/laravel อยู่ในรายการแพ็กเกจที่ค้นพบ

Symfony

php bin/console debug:container nextpdf

คอนเทนเนอร์จะรายงานเอเลียส nextpdf.document และเซอร์วิส PdfFactory

Server

./vendor/bin/generate-skills --dry-run --list-tools

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

Python

nextpdf version

สตริงที่แสดงเวอร์ชันเป็นการยืนยันว่า SDK นำเข้าได้สำเร็จ

ดูเพิ่มเติม

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

เลือกเส้นทางของคุณพิจารณาว่าดิสทริบิวชันและตัวเรนเดอร์ HTML ใดเหมาะกับแอปพลิเคชันของคุณ

การซื้อและการให้สิทธิ์การใช้งานซื้อสิทธิ์การใช้งาน Pro หรือ Enterprise ผ่าน Merchant of Record ของเรา แล้วติดตั้งและเปิดใช้งาน

การผสานรวมแผนผังส่วนขยายทั้งหมดและคู่มือการเลือกใช้

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