Distribuicao
PHP simples → core. App com framework → a integração correspondente. Fronteira de rede → o servidor. Cliente Python → o Python SDK.
Escolha seu caminho
Visão geral
Seção intitulada “Visão geral”O NextPDF oferece vários pontos de entrada. A escolha certa depende de onde o código é executado e de que tipo de saída em Portable Document Format (PDF) você precisa. Use esta página para tomar três decisões: qual distribuição instalar, qual renderizador de Hypertext Markup Language (HTML) usar e quando uma carga de trabalho precisa do Pro ou do Enterprise.
Leia a seção que corresponde à sua dúvida ou dê uma olhada no resumo da decisão ao final.
Escolha uma distribuição
Seção intitulada “Escolha uma distribuição”Comece pela forma como a aplicação chama o motor. Use a primeira linha que corresponde à sua situação.
| Sua situação | Instalar | Por que |
|---|---|---|
| Um projeto PHP simples, uma biblioteca ou uma ferramenta de command-line interface (CLI) | NextPDF core (nextpdf/core) | Apenas o motor. Ele não faz suposições sobre framework e não executa um serviço. |
| Uma aplicação Laravel, Symfony ou CodeIgniter | A integração com framework correspondente | Você obtém vínculos de container, auxiliares de resposta e jobs de fila sobre o core. |
| Um serviço não PHP, um agente ou outro runtime que precisa chamar o motor por uma rede | NextPDF Server (nextpdf/server) | Um único serviço expõe o motor por Model Context Protocol (MCP), REST e gRPC. |
| Código Python que precisa de arquivos PDF de um NextPDF Server | O Python Software Development Kit (SDK) (pip install nextpdf) | Um cliente tipado para um servidor em execução. Ele não incorpora o motor. |
Dois pontos passam facilmente despercebidos:
- Uma integração com framework inclui o core. Você não instala os dois separadamente. O adaptador declara e resolve o
nextpdf/corepara você. - O Python SDK é um cliente, não um motor. Ele se conecta a um endpoint do NextPDF Server. A geração de PDF acontece em PHP no servidor.
Escolha um renderizador HTML
Seção intitulada “Escolha um renderizador HTML”O NextPDF pode renderizar HTML em PDF de quatro maneiras. O pipeline integrado cobre a maioria dos documentos sem configuração adicional. Use os três pacotes de renderizador quando precisar de layout com qualidade de navegador ou se conectar a um serviço já existente.
| Renderizador | Pacote | Onde é executado | Escolha quando |
|---|---|---|---|
Integrado writeHtml() | nextpdf/core | No processo, PHP puro | Você quer um subconjunto suportado de HTML e Cascading Style Sheets (CSS) sem navegador e sem chamada de rede. |
| Artisan | nextpdf/artisan | Chrome headless no host | Você precisa do layout completo do Chrome — flexbox, grid, seletores complexos, web fonts — com texto selecionável. |
| Cloudflare | nextpdf/cloudflare | Cloudflare Browser Rendering na borda | A renderização deve ficar na borda ou você quer manter processos de navegador fora dos seus próprios hosts. |
| Gotenberg | nextpdf/gotenberg | Um serviço Gotenberg que você opera | Você converte documentos de escritório (DOCX, XLSX) ou HTML por meio de uma implantação Gotenberg já existente. |
Como ler a tabela:
- Comece pelo pipeline integrado. É o caminho mais rápido e não tem dependência externa. Antes de depender de uma propriedade, verifique-a na matriz de suporte a CSS.
- Use o Artisan quando um layout for além do subconjunto suportado e a renderização precisar permanecer na sua infraestrutura. Ele inicia um processo do Chrome, então planeje esse ciclo de vida.
- Use o Cloudflare quando quiser a mesma fidelidade de navegador e preferir renderização na borda a processos de navegador locais.
- Use o Gotenberg para conversão de documentos de escritório ou quando você já executa o Gotenberg e quer que o NextPDF o controle.
Quando você precisa do Pro ou do Enterprise
Seção intitulada “Quando você precisa do Pro ou do Enterprise”O motor core gera, renderiza e inspeciona PDFs sem custo e sem licença. O NextPDF Pro e o NextPDF Enterprise são os dois níveis licenciados do pacote nextpdf/premium. Instalá-lo adiciona recursos sem alterar a API do core.
| Você precisa | Nível | Recurso |
|---|---|---|
| Assinar digitalmente um PDF com uma baseline de PDF Advanced Electronic Signatures (PAdES) | Pro | Implementações de assinatura com chave em software. |
| Produzir saída de arquivamento PDF/A | Pro | Conformidade com PDF/A e perfis de arquivamento. |
| Incorporar uma nota fiscal eletrônica (Factur-X / ZUGFeRD) | Pro | Implementações de contrato de nota fiscal eletrônica. |
| Assinar com um hardware security module (HSM) | Enterprise | Operações de chave respaldadas por hardware. |
| Emitir assinaturas eletrônicas qualificadas | Enterprise | Fluxo de trabalho de assinatura qualificada e a superfície completa de conformidade. |
Duas regras mantêm a decisão honesta:
- Se a saída for de PDFs não assinados e não destinados a arquivamento, o core é completo. Você não precisa de uma licença.
- Quando você instala o
nextpdf/premium, as integrações com framework e o servidor o detectam automaticamente. Eles expõem os recursos extras pelas mesmas chaves de container e catálogo de ferramentas. A aplicação não precisa de alterações de código para adotá-lo.
Resumo da decisão
Seção intitulada “Resumo da decisão”Renderizador HTML
Subconjunto suportado, sem dependência → writeHtml(). Fidelidade de
navegador nos seus hosts → Artisan. Na borda →
Cloudflare. Conversão de escritório → Gotenberg.
Nivel licenciado
PDFs não assinados → core. Assinatura, PDF/A, nota fiscal eletrônica → Pro. HSM ou assinaturas qualificadas → Enterprise.
Ainda em duvida?
Instale o core, execute Seu primeiro PDF e adicione um pacote somente quando surgir uma necessidade concreta. Você pode mudar qualquer um desses pontos depois.
Veja também
Seção intitulada “Veja também” Instalar o NextPDF O comando exato para cada distribuicao e renderizador.
Seu primeiro PDF Gere um PDF a partir do PHP e renderize HTML em PDF.
Integracoes O mapa completo de extensoes, o guia de selecao e os manuais por pacote.
Conectar (servidor) Execute o motor como um servico de rede por MCP, REST e gRPC.