Chọn hướng đi của bạn

Tổng quan nhanh

NextPDF có nhiều điểm khởi đầu. Lựa chọn phù hợp phụ thuộc vào nơi mã của bạn chạy và loại đầu ra Portable Document Format (PDF) bạn cần. Hãy dùng trang này để quyết định ba việc: cài đặt bản phân phối nào, dùng bộ kết xuất Hypertext Markup Language (HTML) nào và khi nào một khối lượng công việc cần Pro hoặc Enterprise.

Hãy đọc phần phù hợp với câu hỏi của bạn hoặc lướt qua bản tóm tắt quyết định ở cuối trang.

Chọn một bản phân phối

Hãy bắt đầu từ cách ứng dụng của bạn gọi engine. Hãy dùng hàng đầu tiên phù hợp với tình huống của bạn.

Tình huống của bạn	Cài đặt	Lý do
Một dự án PHP thuần, thư viện hoặc công cụ command-line interface (CLI)	NextPDF core (nextpdf/core)	Chỉ gồm engine. Nó không giả định bạn dùng framework nào và không chạy dưới dạng dịch vụ.
Một ứng dụng Laravel, Symfony hoặc CodeIgniter	Bản tích hợp framework tương ứng	Bạn có các container binding, response helper và queue job được xây dựng trên core.
Một dịch vụ không phải PHP, agent hoặc runtime khác cần gọi engine qua mạng	NextPDF Server (nextpdf/server)	Một dịch vụ duy nhất cung cấp engine qua Model Context Protocol (MCP), REST và gRPC.
Mã Python cần các tệp PDF từ NextPDF Server	Bộ Python Software Development Kit (SDK) (pip install nextpdf)	Client được định kiểu rõ ràng dành cho server đang chạy. Nó không nhúng engine.

Có hai điểm dễ bị bỏ sót:

• Một bản tích hợp framework đã bao gồm core. Bạn không cài đặt riêng cả hai. Adapter sẽ khai báo và resolve nextpdf/core cho bạn.
• Python SDK là một client, không phải engine. Nó kết nối đến endpoint của NextPDF Server. Việc tạo PDF diễn ra bằng PHP trên server.

Thư viện hay dịch vụ?

Nếu ứng dụng PHP của bạn có thể liên kết với thư viện, hãy dùng core hoặc một bản tích hợp framework. Bạn cần ít tiến trình hơn và đạt độ trễ thấp nhất. Hãy dùng server khi mã không phải PHP cần engine, hoặc khi nhiều bên gọi nên dùng chung một dịch vụ kết xuất.

Chọn một bộ kết xuất HTML

NextPDF có thể kết xuất HTML thành PDF theo bốn cách. Pipeline tích hợp sẵn xử lý được hầu hết tài liệu mà không cần thiết lập thêm. Hãy dùng ba gói kết xuất còn lại khi bạn cần bố cục tương đương trình duyệt hoặc cần kết nối đến một dịch vụ sẵn có.

Bộ kết xuất	Gói	Nơi chạy	Chọn khi
Tích hợp sẵn writeHtml()	nextpdf/core	Trong cùng tiến trình, PHP thuần	Bạn muốn tập con HTML và Cascading Style Sheets (CSS) được hỗ trợ mà không cần trình duyệt và không có lệnh gọi mạng.
Artisan	nextpdf/artisan	Chrome chế độ headless trên máy chủ	Bạn cần bố cục Chrome đầy đủ — flexbox, grid, các selector phức tạp, web font — với văn bản có thể chọn được.
Cloudflare	nextpdf/cloudflare	Cloudflare Browser Rendering ở edge	Việc kết xuất nên diễn ra ở edge, hoặc bạn muốn giữ các tiến trình trình duyệt ngoài máy chủ của mình.
Gotenberg	nextpdf/gotenberg	Một dịch vụ Gotenberg do bạn vận hành	Bạn chuyển đổi tài liệu văn phòng (DOCX, XLSX) hoặc HTML thông qua một bản triển khai Gotenberg sẵn có.

Cách đọc bảng:

• Hãy bắt đầu với pipeline tích hợp sẵn. Đây là hướng nhanh nhất và không cần phụ thuộc bên ngoài. Trước khi dựa vào một thuộc tính, hãy đối chiếu nó với ma trận hỗ trợ CSS.
• Hãy dùng Artisan khi bố cục vượt ra ngoài tập con được hỗ trợ và việc kết xuất nên giữ trên hạ tầng của bạn. Nó khởi chạy một tiến trình Chrome, nên hãy tính đến vòng đời của tiến trình đó.
• Hãy dùng Cloudflare khi bạn muốn độ trung thực tương đương trình duyệt và ưu tiên kết xuất ở edge thay vì dùng các tiến trình trình duyệt cục bộ.
• Hãy dùng Gotenberg để chuyển đổi tài liệu văn phòng, hoặc khi bạn đã chạy Gotenberg và muốn NextPDF điều khiển nó.

Các bộ kết xuất mở rộng bề mặt tấn công

Theo mặc định, pipeline tích hợp sẵn không chạy script nào và không tải về tài nguyên từ xa. Artisan, Cloudflare và Gotenberg đều kết xuất thông qua trình duyệt hoặc dịch vụ mạng. Hãy xem HTML là không đáng tin cậy và đọc trang bảo mật và vận hành của từng gói trước khi bạn truyền vào dữ liệu chịu ảnh hưởng từ người dùng.

Khi nào bạn cần Pro hoặc Enterprise

Engine core tạo, kết xuất và kiểm tra PDF mà không tốn chi phí và không cần giấy phép. NextPDF Pro và NextPDF Enterprise là hai bậc giấy phép của gói nextpdf/premium. Việc cài đặt gói này bổ sung các khả năng mà không thay đổi core API.

Bạn cần	Bậc	Khả năng
Ký số một tệp PDF theo baseline PDF Advanced Electronic Signatures (PAdES)	Pro	Các phương thức ký bằng khóa phần mềm.
Tạo đầu ra PDF/A để lưu trữ	Pro	Tuân thủ PDF/A và các profile lưu trữ.
Nhúng hóa đơn điện tử (Factur-X / ZUGFeRD)	Pro	Các phương thức triển khai hợp đồng cho hóa đơn điện tử.
Ký bằng hardware security module (HSM)	Enterprise	Các thao tác khóa dựa trên phần cứng.
Phát hành chữ ký điện tử đủ điều kiện	Enterprise	Quy trình chữ ký đủ điều kiện và toàn bộ phạm vi tuân thủ.

Hai quy tắc giúp bạn quyết định đúng:

• Nếu đầu ra của bạn là các tệp PDF không ký và không dùng để lưu trữ, thì core là đủ. Bạn không cần giấy phép.
• Khi bạn cài đặt nextpdf/premium, các bản tích hợp framework và server sẽ tự động phát hiện gói này. Chúng cung cấp các khả năng bổ sung thông qua cùng những container key và tool catalog. Ứng dụng của bạn không cần đổi mã để sử dụng chúng.

Tóm tắt quyết định

Bản phân phối

PHP thuần → core. Ứng dụng framework → bản tích hợp tương ứng. Ranh giới mạng → server. Client Python → Python SDK.

Bộ kết xuất HTML

Tập con được hỗ trợ, không phụ thuộc → writeHtml(). Độ trung thực trình duyệt trên máy chủ của bạn → Artisan. Ở edge → Cloudflare. Chuyển đổi tài liệu văn phòng → Gotenberg.

Bậc có giấy phép

PDF không ký → core. Ký, PDF/A, hóa đơn điện tử → Pro. HSM hoặc chữ ký đủ điều kiện → Enterprise.

Vẫn chưa chắc chắn?

Cài đặt core, chạy Tệp PDF đầu tiên của bạn, và chỉ thêm một gói khi có nhu cầu cụ thể. Bạn có thể thay đổi mọi lựa chọn này về sau.

Xem thêm

Cài đặt NextPDF Câu lệnh chính xác cho mọi bản phân phối và bộ kết xuất.

Tệp PDF đầu tiên của bạn Tạo một tệp PDF từ PHP và kết xuất HTML thành PDF.

Các bản tích hợp Bản đồ extension đầy đủ, hướng dẫn lựa chọn và tài liệu hướng dẫn cho từng gói.

Kết nối (server) Chạy engine như một dịch vụ mạng qua MCP, REST và gRPC.