Framework integration
Lightweight CodeIgniter 4 integration—services, library, and response helpers.
NextPDF CodeIgniter provides first-class CodeIgniter 4 integration for NextPDF. It includes a Pdf library for controllers, CI4 Services with singleton registries, a PdfResponse helper with OWASP security headers, global helper functions, and automatic detection of installed NextPDF extensions (NextPDF Artisan, NextPDF Pro).
How it fits
A typed BaseConfig object exposes NextPDF’s settings as real PHP properties, and any of them can be overridden from your .env file using the nextpdf.* prefix. Environment overrides flow through BaseConfig to the Pdf library. Defaults stay strongly typed, so your editor and static analysis still see the right shapes.
The global pdf() and pdf_document() helper shortcuts collapse setup into a single call from anywhere in your app. pdf() builds and delivers a document in one step, while pdf_document() hands you a fresh Document to compose. Both route through the same Pdf library, so behaviour stays consistent whether you use a helper or the service.
Push a GeneratePdfJob onto the CodeIgniter 4 queue and let a background worker render large documents off the request path. The integration builds on codeigniter4/queue, so dispatched jobs are picked up and processed by your existing worker setup, and rendering runs outside the request that triggered it.
Get started
composer require nextpdf/codeigniterIn code
use NextPDF\CodeIgniter\Config\Services;
public function download(int $id): \CodeIgniter\HTTP\DownloadResponse
{
$pdf = Services::pdf();
$pdf->document()->addPage();
$pdf->document()->cell(0, 10, "Invoice #{$id}");
return $pdf->download("invoice-{$id}.pdf");
}use NextPDF\CodeIgniter\Jobs\GeneratePdfJob;
service('queue')->push('pdf', GeneratePdfJob::class, [
'builder' => 'App\PdfBuilders\InvoiceBuilder::build',
'outputPath' => WRITEPATH . 'pdfs/invoice-42.pdf',
'context' => ['invoice_id' => 42],
]);Capabilities
When to use it
Choose this for CodeIgniter 4 projects that want a lightweight Pdf library and Services-based registries, with .env-driven configuration and optional CI4 Queue for async jobs.