PDF pertama Anda

Gambaran umum

Dalam tutorial ini, Anda akan menghasilkan dua berkas PDF. Pertama, Anda menulis teks secara langsung dengan Application Programming Interface (API) inti yang fluent. Kemudian, Anda merender fragmen Hypertext Markup Language (HTML) dengan Cascading Style Sheets (CSS) ke dalam sebuah halaman. Di akhir tutorial, Anda akan memiliki skrip yang berfungsi dan dapat disesuaikan untuk dokumen nyata, serta tautan ke varian framework dan server.

Kedua pendekatan ini berjalan di mesin yang sama, sehingga apa yang Anda pelajari di sini berlaku di setiap distribusi.

Diagram di bawah ini menunjukkan dua pendekatan penyusunan dan tiga permukaan deployment yang menggunakannya kembali.

From your code to a PDF file

Sebelum Anda memulai

Anda memerlukan mesin inti yang sudah terpasang serta lingkungan untuk menjalankan skrip PHP.

1. Pastikan PHP 8.4 menjadi runtime yang aktif:

   php --version

2. Pasang mesin inti di proyek Anda, jika belum tersedia:

   composer require nextpdf/core

3. Buat berkas kerja bernama first-pdf.php di root proyek.

14 fon standar dapat digunakan tanpa penyiapan

Tampilan standar untuk teks isi mengarah ke salah satu dari 14 fon Type 1 standar yang disebutkan dalam ISO 32000-2. Dokumen pertama Anda tidak memerlukan berkas fon. Daftarkan dan sematkan fon kustom nanti, ketika desain membutuhkannya.

Menghasilkan PDF dari PHP

Mulailah dengan API yang fluent. Document::createStandalone() mengembalikan dokumen yang dapat langsung Anda gunakan. Tambahkan halaman, atur fon, tulis sel, lalu simpan. Setiap metode penyusunan mengembalikan dokumen, sehingga rangkaian panggilannya terbaca dari atas ke bawah.

1. Letakkan kode ini di first-pdf.php. Skrip ini mendeklarasikan strict types, memuat autoloader, dan membangun satu halaman:

   <?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. Jalankan skrip:

   php first-pdf.php

3. Periksa keluarannya. Anda akan melihat baris ini pada keluaran standar dan berkas baru bernama first-pdf.pdf di samping skrip:

   Wrote first-pdf.pdf

Anda kini telah menghasilkan berkas PDF 2.0 yang valid. Buka berkas itu di penampil PDF apa pun untuk melihat judul dan baris di bawahnya.

save versus output

save() menulis dokumen ke sebuah path berkas. Untuk mengalirkan byte-nya ke peramban, panggil output(). Untuk menangkap byte-nya di memori, panggil getPdfData(). Satu dokumen hanya bisa dipakai sekali. Setelah Anda menuliskannya, buat instance baru untuk dokumen berikutnya alih-alih menggunakannya kembali.

Merender HTML menjadi PDF

Menulis sel memberi Anda kendali yang presisi. Namun, sebagian besar dokumen lebih cepat disusun sebagai HTML dan CSS. Mesin inti menyertakan pipeline HTML pure-PHP. Metode writeHtml() merender fragmen ke dalam halaman saat ini. Metode ini tidak menggunakan peramban atau layanan eksternal.

1. Buat berkas kedua, html-pdf.php, yang merender fragmen 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. Jalankan:

   php html-pdf.php

3. Konfirmasikan baris keluaran dan berkas baru:

   Wrote html-pdf.pdf

Perlakukan masukan HTML sebagai tidak tepercaya

Ketika HTML berasal dari pengguna, formulir, atau sumber eksternal apa pun, validasi dan bersihkan terlebih dahulu sebelum Anda meneruskannya ke writeHtml(). Resep Merender HTML menjadi halaman PDF membahas postur keamanan dan model streaming secara lengkap.

Mesin merender subset HTML dan CSS yang didukung. Sebelum Anda mengandalkan suatu properti, periksa matriks dukungan CSS. Ketika tata letak membutuhkan hasil yang sepenuhnya setara dengan peramban, seperti flexbox, grid, atau web font, pasang renderer Artisan dan panggil writeHtmlChrome(). Metode itu menjaga teks tetap dapat diseleksi.

Dari controller framework

Aplikasi Anda mungkin sudah berjalan di dalam framework atau melalui server. Dua panggilan yang sama dapat dipindahkan ke lingkungan tersebut. Mesinnya tetap sama. Hanya penyambungannya yang berubah.

Laravel

Facade Pdf menyediakan dokumen baru untuk setiap panggilan. PdfResponse mengubah dokumen menjadi respons unduhan:

<?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');
    }
}

Lihat panduan cepat Laravel.

Symfony

Bundle ini mengekspos layanan PdfFactory. Beri type-hint NextPDF\Symfony\Service\PdfFactory di sebuah controller, bangun dokumen dengan cara yang sama, lalu kembalikan sebagai respons HTTP. Lihat panduan cepat Symfony.

Server (REST)

Dengan NextPDF Server yang berjalan, kirim sebuah array operasi terurut melalui POST, dan server mengembalikan 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

Untuk respons 200, body-nya adalah PDF. Lihat panduan cepat Connect.

Langkah selanjutnya

Anda kini telah menghasilkan PDF dengan tiga cara. Gunakan halaman-halaman ini untuk mengembangkan masing-masing pendekatan tersebut.

Merender HTML menjadi halaman PDF Resep HTML lengkap: elemen yang didukung, model streaming, dan postur keamanan.

Pilih jalur Anda Tentukan pilihan antara inti, sebuah framework, server, dan renderer HTML mana yang akan digunakan.

Referensi mesin inti Setiap metode, parameter, dan nilai kembalian Document.

Cookbook Resep yang berfokus pada tugas untuk penggayaan, tabel, paginasi, dan lainnya.