PDF đầu tiên của bạn

Tổng quan nhanh

Trong hướng dẫn này, bạn sẽ tạo hai tệp PDF. Trước tiên, bạn viết văn bản trực tiếp bằng core Application Programming Interface (API) dạng fluent. Sau đó, bạn kết xuất một đoạn Hypertext Markup Language (HTML) có Cascading Style Sheets (CSS) thành một trang. Khi hoàn tất, bạn sẽ có một script chạy được để điều chỉnh cho tài liệu thực tế, cùng các liên kết đến các biến thể framework và server.

Cả hai cách tiếp cận đều chạy trên cùng một engine, nên những gì bạn học ở đây áp dụng cho mọi bản phân phối.

Sơ đồ bên dưới cho thấy hai cách tạo nội dung và ba bề mặt triển khai có thể dùng lại chúng.

From your code to a PDF file

Trước khi bắt đầu

Bạn cần cài đặt core engine và có môi trường để chạy script PHP.

1. Xác nhận PHP 8.4 là runtime hiện đang hoạt động:

   php --version

2. Cài đặt core engine vào dự án của bạn, nếu chưa có sẵn:

   composer require nextpdf/core

3. Tạo một tệp làm việc có tên first-pdf.php trong thư mục gốc của dự án.

14 phông chữ tiêu chuẩn hoạt động mà không cần thiết lập

Phông chữ thân văn bản mặc định được phân giải thành một trong 14 phông chữ Type 1 tiêu chuẩn được nêu tên trong ISO 32000-2. Tài liệu đầu tiên của bạn không cần tệp phông chữ nào. Hãy đăng ký và nhúng phông chữ tùy chỉnh sau, khi thiết kế cần đến chúng.

Tạo PDF từ PHP

Bắt đầu với fluent API. Document::createStandalone() trả về một tài liệu có thể dùng ngay. Thêm một trang, đặt phông chữ, viết các cell, rồi lưu. Mỗi phương thức tạo nội dung đều trả về tài liệu, nên chuỗi lệnh gọi có thể đọc từ trên xuống dưới.

1. Đưa đoạn code này vào first-pdf.php. Script khai báo strict types, nạp autoloader và dựng một trang:

   <?php
   
   declare(strict_types=1);
   
   require_once __DIR__ . '/vendor/autoload.php';
   
   use NextPDF\Core\Document;
   
   $document = Document::createStandalone();
   $document->setTitle('My first NextPDF document');
   $document->addPage();
   
   $document->setFont('helvetica', 'B', 24);
   $document->cell(0, 15, 'Hello, NextPDF!', newLine: true);
   
   $document->setFont('helvetica', '', 12);
   $document->cell(0, 10, 'This is the first PDF I generated with PHP.', newLine: true);
   
   $document->save(__DIR__ . '/first-pdf.pdf');
   
   echo "Wrote first-pdf.pdf\n";

2. Chạy script:

   php first-pdf.php

3. Kiểm tra kết quả đầu ra. Bạn sẽ thấy dòng này trên standard output và một tệp mới có tên first-pdf.pdf nằm cạnh script:

   Wrote first-pdf.pdf

Bây giờ bạn đã tạo được một tệp PDF 2.0 hợp lệ. Mở tệp đó trong bất kỳ trình xem PDF nào để thấy tiêu đề và dòng bên dưới.

save so với output

save() ghi tài liệu vào một đường dẫn tệp. Nếu muốn truyền luồng byte tới trình duyệt thay vào đó, hãy gọi output(). Nếu muốn giữ các byte trong bộ nhớ, hãy gọi getPdfData(). Mỗi tài liệu chỉ dùng được một lần. Sau khi đã ghi một tài liệu, hãy tạo một instance mới cho tài liệu tiếp theo thay vì dùng lại instance cũ.

Kết xuất HTML thành PDF

Viết các cell cho bạn khả năng kiểm soát chính xác. Tuy nhiên, với hầu hết tài liệu, diễn đạt bằng HTML và CSS sẽ nhanh hơn. Core engine bao gồm một pipeline HTML thuần PHP. Phương thức writeHtml() kết xuất một đoạn vào trang hiện tại. Nó không dùng trình duyệt hay dịch vụ bên ngoài.

1. Tạo một tệp thứ hai, html-pdf.php, để kết xuất một đoạn HTML:

   <?php
   
   declare(strict_types=1);
   
   require_once __DIR__ . '/vendor/autoload.php';
   
   use NextPDF\Core\Document;
   
   $document = Document::createStandalone();
   $document->setTitle('HTML to PDF');
   $document->addPage();
   
   $html = <<<'HTML'
   <h1 style="color: #1E3A8A;">HTML rendering in NextPDF</h1>
   <p>NextPDF renders <strong>HTML content</strong> directly into PDF pages.</p>
   <ul>
       <li>Headings, paragraphs, and lists</li>
       <li>Inline <strong>bold</strong> and <em>italic</em></li>
       <li>Inline styles such as color and font-size</li>
   </ul>
   HTML;
   
   $document->writeHtml($html);
   
   $document->save(__DIR__ . '/html-pdf.pdf');
   
   echo "Wrote html-pdf.pdf\n";

2. Chạy tệp đó:

   php html-pdf.php

3. Kiểm tra dòng kết quả và tệp mới:

   Wrote html-pdf.pdf

Coi đầu vào HTML là không đáng tin cậy

Khi HTML đến từ người dùng, một biểu mẫu hoặc bất kỳ nguồn bên ngoài nào, hãy kiểm tra và làm sạch nó trước khi truyền vào writeHtml(). Công thức Kết xuất HTML thành một trang PDF trình bày đầy đủ thế trận bảo mật và mô hình truyền luồng.

Engine kết xuất tập con HTML và CSS được hỗ trợ. Trước khi dựa vào một thuộc tính, hãy kiểm tra ma trận hỗ trợ CSS. Khi bố cục cần độ trung thực đầy đủ của trình duyệt, chẳng hạn flexbox, grid hoặc web font, hãy cài đặt Artisan renderer và gọi writeHtmlChrome() thay thế. Phương thức đó giữ cho văn bản vẫn chọn được.

Từ một controller của framework

Ứng dụng của bạn có thể đã chạy trong một framework hoặc thông qua server. Hai lệnh gọi đó vẫn được đưa vào môi trường ấy. Engine không đổi. Chỉ phần kết nối thay đổi.

Laravel

Facade Pdf phân giải một tài liệu mới cho mỗi lệnh gọi. PdfResponse chuyển tài liệu thành phản hồi tải xuống:

<?php

declare(strict_types=1);

namespace App\Http\Controllers;

use Illuminate\Http\Response;
use NextPDF\Contracts\PdfDocumentInterface;
use NextPDF\Laravel\Http\PdfResponse;

final class ReportController extends Controller
{
    public function download(): Response
    {
        $document = app(PdfDocumentInterface::class);
        $document->addPage();
        $document->cell(0, 10, 'Monthly report', newLine: true);

        return PdfResponse::download($document, 'report.pdf');
    }
}

Xem hướng dẫn khởi động nhanh Laravel.

Symfony

Bundle cung cấp một service PdfFactory. Khai báo type-hint NextPDF\Symfony\Service\PdfFactory trong một controller, dựng tài liệu theo cùng cách, rồi trả về dưới dạng phản hồi HTTP. Xem hướng dẫn khởi động nhanh Symfony.

Server (REST)

Khi NextPDF Server đang chạy, hãy POST một mảng operations có thứ tự; server sẽ trả về các byte PDF:

curl -sS -X POST http://localhost:8080/api/v1/render \
  -H 'Authorization: Bearer <api-key>' \
  -H 'Content-Type: application/json' \
  -d '{
        "page_size": "A4",
        "orientation": "portrait",
        "operations": [
          { "type": "add_text", "text": "Hello from NextPDF Connect" }
        ]
      }' \
  --output hello.pdf

Khi nhận phản hồi 200, phần thân chính là PDF. Xem hướng dẫn khởi động nhanh Connect.

Bước tiếp theo

Bây giờ bạn đã tạo được PDF theo ba cách. Hãy dùng các trang này để tiếp tục xây dựng trên từng cách.

Kết xuất HTML thành một trang PDF Công thức HTML đầy đủ: các phần tử được hỗ trợ, mô hình truyền luồng, và thế trận bảo mật.

Chọn hướng đi của bạn Quyết định giữa core, một framework, server, và dùng trình kết xuất HTML nào.

Tài liệu tham khảo core engine Mọi phương thức, tham số, và giá trị trả về của Document.

Cookbook Các công thức tập trung vào tác vụ cho việc tạo kiểu, bảng, phân trang, và nhiều hơn nữa.