Bắt đầu với NextPDF

Tổng quan nhanh

NextPDF là engine PHP 8.4 dùng để tạo và kiểm tra tài liệu Portable Document Format (PDF) 2.0, định dạng tệp do ISO 32000-2 định nghĩa. Bạn xây dựng tài liệu thông qua một application programming interface (API) có kiểu rõ ràng và nhất quán. Bạn kết xuất Hypertext Markup Language (HTML) và Cascading Style Sheets (CSS) thành các trang. Bạn ký và lưu trữ kết quả đầu ra, rồi đọc lại nội dung có cấu trúc. Tất cả chạy trong PHP, và các luồng xử lý cốt lõi không cần tệp nhị phân bên ngoài.

Dự án được phát hành dưới dạng bốn bản phân phối, gồm open source software (OSS) và các bậc có bản quyền. Tất cả đều dùng chung một engine nền, vì vậy hãy cài đặt bản phù hợp với cách bạn làm việc.

Bản phân phối	Gói	Cài đặt khi
NextPDF core (OSS)	`nextpdf/core`	Bạn viết PHP và muốn truy cập trực tiếp vào engine, dù dùng cùng một framework hay chạy độc lập.
NextPDF Server (OSS)	`nextpdf/server`	Bạn muốn một dịch vụ độc lập cung cấp engine qua Model Context Protocol (MCP), Representational State Transfer (REST) và gRPC.
NextPDF Pro	`nextpdf/premium` (bậc Pro)	Bạn cần ký số, lưu trữ PDF/A hoặc đầu ra cho hóa đơn điện tử.
NextPDF Enterprise	`nextpdf/premium` (bậc Enterprise)	Bạn cần ký số được phần cứng hỗ trợ, chữ ký đủ điều kiện và phạm vi tuân thủ đầy đủ.

NextPDF Pro và NextPDF Enterprise là các bậc có bản quyền trong cùng một gói nextpdf/premium. Engine cốt lõi hoạt động như nhau dù gói đó có được cài đặt hay không.

Cài đặt chỉ trong một dòng

Trong một dự án PHP thuần, hãy cài đặt engine cốt lõi bằng Composer.

composer require nextpdf/core

Chỉ gói đó là đủ để tạo và kiểm tra các tệp PDF mà không cần thiết lập thêm. Các bản tích hợp framework, bộ kết xuất HTML, server và Python software development kit (SDK) đều bổ sung thêm một gói phía trên. Hướng dẫn cài đặt liệt kê đầy đủ các lệnh.

Chọn lối đi của bạn

NextPDF phù hợp với mã nguồn bạn đang có. Hãy chọn điểm khởi đầu phù hợp với stack của bạn, rồi mở thẻ tương ứng.

Cài đặt Ma trận cài đặt đầy đủ: core, các bản tích hợp framework, bộ kết xuất HTML, server, và Python SDK.

Tệp PDF đầu tiên của bạn Một hướng dẫn ngắn tạo một tệp PDF từ PHP, sau đó kết xuất HTML thành PDF.

Chọn lối đi của bạn Một hướng dẫn ra quyết định giữa core, một framework và server, cùng bộ kết xuất HTML nào nên dùng.

Tích hợp Bộ chuyển đổi framework, bộ kết xuất trình duyệt, dịch vụ edge, và các gói di trú.

Đi tiếp đến đâu

Sau khi tạo tài liệu đầu tiên, hãy dùng ba khu vực chính sau trong tài liệu hướng dẫn.

Hướng dẫn và tích hợp Vận hành gói phù hợp với framework, bộ kết xuất, runtime, hoặc mục tiêu di trú của bạn — Laravel, Symfony, CodeIgniter, Artisan, Cloudflare, và Gotenberg.

Tài liệu tham khảo API Bề mặt engine đã được xác minh: các lớp, phương thức, khóa cấu hình, và ma trận hỗ trợ CSS.

Cookbook Các công thức tập trung vào tác vụ — kết xuất HTML thành PDF, tạo kiểu bằng CSS, bố trí bảng, và phân trang nội dung dài.

Tại sao cần một server riêng?

Hãy cài đặt NextPDF Server khi một dịch vụ không phải PHP, một agent hoặc một runtime khác cần gọi engine qua một giao thức mạng thay vì liên kết với thư viện. Python SDK là client có kiểu rõ ràng dành cho server đó.