HTML Renderer
Class HtmlRenderer adalah entry point utama untuk semua operasi HTML-ke-PDF. Class ini menyediakan API fluent untuk memuat konten, mengonfigurasi output, dan me-render dokumen PDF.
Factory Method
Buat instance renderer dengan factory statis create().
php
use Yeeefang\TcpdfNext\Artisan\HtmlRenderer;
// Konfigurasi default (auto-detect Chrome)
$renderer = HtmlRenderer::create();
// Dengan path binary Chrome kustom
$renderer = HtmlRenderer::create(
chromePath: '/usr/bin/google-chrome',
);
// Dengan direktori temporary kustom
$renderer = HtmlRenderer::create(
chromePath: '/usr/bin/chromium',
tempDir: '/tmp/artisan-render',
);Memuat Konten
Dari String
Berikan HTML mentah langsung dengan loadHtml(). String bisa berupa dokumen HTML lengkap atau fragmen.
php
$renderer->loadHtml('<h1>Hello, World!</h1>');Saat Anda memberikan fragmen, Artisan membungkusnya dalam dokumen <!DOCTYPE html> minimal secara otomatis.
Dari File Lokal
Muat file .html dari disk dengan loadFile(). Path relatif ke stylesheet, gambar, dan script di dalam file di-resolve dari direktori file tersebut.
php
$renderer->loadFile('/templates/quarterly-report.html');Dari URL
Ambil dan render URL langsung dengan loadUrl(). Halaman dimuat di dalam Chrome headless, sehingga JavaScript dieksekusi dan panggilan AJAX selesai sebelum rendering.
php
$renderer->loadUrl('https://reports.example.com/q4-2026');Anda bisa mengatur timeout navigasi untuk mencegah hang pada halaman lambat:
php
$renderer->loadUrl('https://example.com/dashboard', timeoutMs: 30000);Method Output
Simpan ke File
php
$renderer->save('/output/report.pdf');Dapatkan sebagai String
Ambil byte PDF mentah untuk pemrosesan lebih lanjut (misalnya, simpan di database, lampirkan ke email).
php
$pdfContent = $renderer->toString();
// Contoh: simpan ke database
DB::table('documents')->insert([
'name' => 'report.pdf',
'content' => $pdfContent,
]);Kirim ke Browser
Stream PDF langsung ke respons HTTP dengan header yang sesuai.
php
// Tampilan inline (PDF viewer browser)
$renderer->output('report.pdf', 'inline');
// Paksa download
$renderer->output('report.pdf', 'download');Contoh Lengkap: Invoice
php
use Yeeefang\TcpdfNext\Artisan\HtmlRenderer;
$html = <<<'HTML'
<!DOCTYPE html>
<html>
<head>
<style>
body { font-family: 'Inter', sans-serif; margin: 20mm; }
.header { display: flex; justify-content: space-between; align-items: flex-start; }
.company { font-size: 24px; font-weight: 700; color: #1a237e; }
.meta { text-align: right; color: #666; font-size: 13px; }
.grid { display: grid; grid-template-columns: 1fr 1fr; gap: 20px; margin: 30px 0; }
.grid section { padding: 15px; background: #f8f9fa; border-radius: 6px; }
table { width: 100%; border-collapse: collapse; margin-top: 20px; }
th { background: #1a237e; color: white; padding: 10px 12px; text-align: left; }
td { border-bottom: 1px solid #e0e0e0; padding: 10px 12px; }
tr:nth-child(even) { background: #fafafa; }
.total { font-weight: 700; font-size: 18px; text-align: right; margin-top: 20px; }
</style>
</head>
<body>
<div class="header">
<div class="company">Acme Corporation</div>
<div class="meta">
Invoice #2026-001<br>
Date: 2026-02-16<br>
Due: 2026-03-16
</div>
</div>
<div class="grid">
<section>
<strong>Bill To</strong><br>
Jane Smith<br>
456 Oak Avenue<br>
Springfield, IL 62704
</section>
<section>
<strong>Ship To</strong><br>
Jane Smith<br>
789 Elm Street<br>
Springfield, IL 62704
</section>
</div>
<table>
<thead>
<tr>
<th>Item</th>
<th>Qty</th>
<th>Unit Price</th>
<th>Amount</th>
</tr>
</thead>
<tbody>
<tr><td>Web Development</td><td>40 hrs</td><td>$150.00</td><td>$6,000.00</td></tr>
<tr><td>UI/UX Design</td><td>20 hrs</td><td>$125.00</td><td>$2,500.00</td></tr>
<tr><td>Annual Hosting</td><td>1</td><td>$1,200.00</td><td>$1,200.00</td></tr>
</tbody>
</table>
<div class="total">Total: $9,700.00</div>
</body>
</html>
HTML;
HtmlRenderer::create()
->loadHtml($html)
->save('/invoices/2026-001.pdf');Method Chaining
Setiap setter di HtmlRenderer mengembalikan $this, memungkinkan pola fluent builder.
php
use Yeeefang\TcpdfNext\Artisan\HtmlRenderer;
use Yeeefang\TcpdfNext\Artisan\RenderOptions;
use Yeeefang\TcpdfNext\Artisan\StyleInjector;
HtmlRenderer::create()
->loadFile('/templates/report.html')
->withOptions(
RenderOptions::create()
->setPageSize('A4')
->setLandscape(false)
->setMargins(top: 15, right: 10, bottom: 15, left: 10)
->setPrintBackground(true)
)
->withStyleInjector(
StyleInjector::create()
->addCss('body { font-size: 12pt; }')
)
->save('/output/styled-report.pdf');Penanganan Error
php
use Yeeefang\TcpdfNext\Artisan\HtmlRenderer;
use Yeeefang\TcpdfNext\Artisan\Exceptions\RenderException;
use Yeeefang\TcpdfNext\Artisan\Exceptions\ChromeNotFoundException;
use Yeeefang\TcpdfNext\Artisan\Exceptions\TimeoutException;
try {
HtmlRenderer::create()
->loadUrl('https://example.com/slow-report')
->save('/output/report.pdf');
} catch (ChromeNotFoundException $e) {
// Binary Chrome tidak ditemukan -- periksa CHROME_PATH
logger()->error('Chrome not installed: ' . $e->getMessage());
} catch (TimeoutException $e) {
// Halaman terlalu lama untuk dimuat atau di-render
logger()->warning('Render timed out: ' . $e->getMessage());
} catch (RenderException $e) {
// Kegagalan rendering lainnya
logger()->error('Render failed: ' . $e->getMessage());
}Langkah Selanjutnya
- Render Options -- Fine-tune ukuran halaman, margin, header, dan footer.
- Fitur Lanjutan -- Penggabungan PDF, injeksi CSS, screenshot.