Começando com o NextPDF

Visão geral

O NextPDF é um motor em PHP 8.4 para gerar e inspecionar documentos Portable Document Format (PDF) 2.0, o formato de arquivo definido pela ISO 32000-2. Você monta documentos por meio de uma application programming interface (API) tipada e fluente, renderiza Hypertext Markup Language (HTML) e Cascading Style Sheets (CSS) em páginas, assina e arquiva a saída e lê de volta o conteúdo estruturado. Tudo isso roda em PHP, e os principais caminhos não dependem de nenhum binário externo.

O projeto é oferecido em quatro distribuições, incluindo open source software (OSS) e versões licenciadas. Todas compartilham o mesmo motor de base, então instale a que melhor corresponde ao seu fluxo de trabalho.

Distribuição	Pacote	Instale quando
NextPDF core (OSS)	`nextpdf/core`	Você escreve em PHP e quer acesso direto ao motor, com um framework ou de forma independente.
NextPDF Server (OSS)	`nextpdf/server`	Você quer um serviço autônomo que exponha o motor via Model Context Protocol (MCP), Representational State Transfer (REST) e gRPC.
NextPDF Pro	`nextpdf/premium` (versão Pro)	Você precisa de assinatura digital, arquivamento em PDF/A ou saída de nota fiscal eletrônica.
NextPDF Enterprise	`nextpdf/premium` (versão Enterprise)	Você precisa de assinatura baseada em hardware, assinaturas qualificadas e a cobertura completa de conformidade.

O NextPDF Pro e o NextPDF Enterprise são versões licenciadas do mesmo pacote nextpdf/premium. O motor principal se comporta da mesma forma, esteja esse pacote instalado ou não.

Instale com uma linha

Em um projeto PHP básico, instale o motor principal com o Composer.

composer require nextpdf/core

Esse único pacote gera e inspeciona PDFs sem configuração adicional. As integrações com frameworks, os renderizadores de HTML, o servidor e o software development kit (SDK) de Python acrescentam um pacote extra cada um. O guia de instalação lista todos os comandos.

Escolha seu caminho

O NextPDF se integra ao código que você já tem. Escolha o ponto de entrada que corresponde à sua stack e, em seguida, abra o card correspondente.

Instalação A matriz completa de instalação: core, integrações com frameworks, renderizadores de HTML, o servidor e o SDK de Python.

Seu primeiro PDF Um tutorial curto que gera um PDF a partir de PHP e depois renderiza HTML em PDF.

Escolha seu caminho Um guia de decisão entre o core, um framework e o servidor, e qual renderizador de HTML usar.

Integrações Adaptadores de frameworks, renderizadores de navegador, serviços edge e pacotes de migração.

Para onde ir em seguida

Depois de gerar seu primeiro documento, siga para estas três áreas principais da documentação.

Guias e integrações Opere o pacote que corresponde ao seu framework, renderizador, runtime ou alvo de migração — Laravel, Symfony, CodeIgniter, Artisan, Cloudflare e Gotenberg.

Referência da API A superfície verificada do motor: classes, métodos, chaves de configuração e a matriz de suporte a CSS.

Cookbook Receitas focadas em tarefas — renderizar HTML em PDF, estilizar com CSS, dispor tabelas e paginar conteúdo longo.

Por que um servidor separado?

Instale o NextPDF Server quando um serviço não-PHP, um agente ou outro runtime precisar chamar o motor por um protocolo de rede em vez de se vincular diretamente à biblioteca. O SDK de Python é o cliente tipado para esse servidor.