Cookbook

Tổng quan nhanh

Cookbook được tổ chức theo tác vụ. Mỗi công thức giải quyết một vấn đề bằng một mẫu có thể sao chép, có mã nguồn hỗ trợ. Các công thức được chia thành ba nhóm theo nơi chạy công việc. Chọn nhóm phù hợp với cách bạn gọi NextPDF, rồi mở công thức bạn cần.

Nếu muốn hiểu tại sao engine hoạt động theo một cách nhất định, hãy đọc Guides thay vào đó. Để xem giao diện lập trình ứng dụng (API) đã được kiểm chứng, hãy đọc Reference.

Một mẫu, một runtime

Mỗi công thức nhắm tới một runtime. Các công thức PHP gọi core engine ngay trong tiến trình. Các công thức Connect gọi công cụ qua một transport. Các công thức tích hợp kết nối NextPDF vào một framework hoặc renderer backend. Hãy đọc trang quy ước tương ứng trước khi điều chỉnh một mẫu.

Công thức PHP

Các công thức PHP chạy core engine trực tiếp trong tiến trình. Mỗi công thức bắt đầu bằng composer require nextpdf/core, rồi dùng API công khai để dựng, ký, kiểm tra hoặc chuyển đổi tài liệu, bao gồm Document::createStandalone() và writeHtml().

Công thức PHP Bản đồ của mọi công thức PHP-native: kết xuất HTML thành PDF, bố trí bảng, nhúng và subset phông chữ, mã hóa bằng AES-256, ký bằng PAdES, xuất PDF/A-4 và PDF/UA-2 đã gắn thẻ, trích xuất văn bản và kiểm tra các tệp hiện có.

Công thức Connect

Các công thức Connect gọi NextPDF qua sổ đăng ký công cụ của máy chủ, bằng Model Context Protocol (MCP), Representational State Transfer (REST) hoặc gRPC. Cùng một lệnh gọi công cụ hoạt động trên cả ba transport và luôn nằm sau cổng xác nhận có sự tham gia của con người.

Công thức Connect Các công thức độc lập với transport cho máy chủ NextPDF Connect: hello world, bảng HTML, nhúng hình ảnh, chữ ký số, kiểm tra khả năng truy cập và tuân thủ, biên tập che, phân tích pháp y và khả năng quan sát với OpenTelemetry.

Công thức tích hợp

Các công thức tích hợp cho thấy cách kết nối NextPDF vào một framework ứng dụng hoặc ủy thác phần kết xuất cho một backend bên ngoài. Chúng bao gồm các adapter framework, renderer bridge và lộ trình di chuyển từ thư viện cũ.

Công thức tích hợp Các công thức cho những gói trong hệ sinh thái: chọn một bản tích hợp, trả về một PDF từ controller của framework, đưa việc tạo vào hàng đợi trong một background job, kết xuất HTML với Artisan, chuyển đổi các tệp Office với Gotenberg, kết xuất tại edge với Cloudflare và theo lộ trình di chuyển TCPDF.

Quy ước công thức

Mọi công thức đều tuân theo một hợp đồng đã được ghi tài liệu: các mẫu được hỗ trợ bởi mã nguồn, front-matter của hồ sơ khả năng tái lập, một ranh giới tuân thủ trung thực và cổng xuất bản. Hãy đọc trang quy ước cho nhóm công thức của bạn trước khi điều chỉnh một mẫu.

Quy ước công thức tích hợp Hợp đồng mà mọi công thức tích hợp có thể chạy đều tuân theo: các mẫu được hỗ trợ bởi mã nguồn, front-matter của hồ sơ khả năng tái lập và cổng xuất bản.

Quy ước công thức Connect Hợp đồng mà mọi công thức Connect đều tuân theo: các lệnh gọi công cụ độc lập với transport, các công cụ tùy theo cấp bậc, mô hình rủi ro và cổng xác nhận, cùng ranh giới tuân thủ trung thực.

Xem thêm

• Guides — tài liệu khái niệm và hướng dẫn cách làm.
• Reference — API đã được kiểm chứng và ma trận hỗ trợ Cascading Style Sheets (CSS).
• Choose an integration — ma trận quyết định ánh xạ các trường hợp sử dụng tới các bản tích hợp.