Instalar o NextPDF

Visão geral

Instale qualquer distribuição do NextPDF com um único comando do gerenciador de pacotes. As distribuições PHP usam o Composer; o software development kit (SDK) para Python usa o pip. Escolha a aba que corresponde ao que você está construindo. Execute o comando e, em seguida, verifique o resultado no final desta página.

Requisitos

O NextPDF foi projetado para um único runtime moderno. Essas restrições vêm diretamente dos próprios arquivos composer.json dos pacotes.

Requisito	Restrição	Notas
PHP	`>=8.4 <9.0`	O Composer se recusa a instalar no PHP 8.3 ou inferior, ou no PHP 9.
Composer	2.7 ou mais recente	Necessário para a resolução de dependências e a geração do autoloader.
`ext-mbstring`	Necessário	Tratamento de strings multibyte para layout de texto.
`ext-zlib`	Necessário	Compressão de fluxo (stream) para objetos do Portable Document Format (PDF).
Chrome ou Chromium	Opcional	Apenas para o renderizador Artisan (`writeHtmlChrome()`).
Serviço Gotenberg	Opcional	Apenas para conversão de documentos office e HTML por meio do Gotenberg.
Python	3.10 ou mais recente	Apenas para o SDK para Python.

ext-mbstring e ext-zlib vêm habilitadas em todos os builds de PHP suportados. As integrações verificam a presença delas durante a inicialização e interrompem a execução com uma mensagem clara se alguma estiver faltando.

Instalar o core

Para gerar e inspecionar arquivos PDF a partir do PHP, você precisa apenas do motor principal.

composer require nextpdf/core

Faça commit do composer.lock para que cada worker implantado use a mesma versão do motor. Após a instalação, prossiga para Seu primeiro PDF.

Instalar uma integração com framework

Instale um adaptador de framework para obter bindings de container, helpers de resposta e jobs de fila. Cada adaptador declara o nextpdf/core e resolve a dependência para você.

composer require nextpdf/laravel

A descoberta automática (auto-discovery) registra o service provider e a facade Pdf. Em seguida, publique o arquivo de configuração:

php artisan vendor:publish --tag=nextpdf-config

Consulte o guia de instalação do Laravel e o quickstart do Laravel.

composer require nextpdf/symfony

Em uma aplicação Symfony Flex, o bundle se registra sozinho. Em uma aplicação não-Flex, adicione você mesmo o NextPDF\Symfony\NextPdfBundle ao config/bundles.php. Consulte o guia de instalação do Symfony.

composer require nextpdf/codeigniter

O CodeIgniter 4 descobre automaticamente a classe Services e o helper pdf(), portanto você não precisa de registro manual. Consulte o guia de instalação do CodeIgniter.

Instalar um renderizador ou serviço

O NextPDF renderiza HTML para PDF de três maneiras. Instale a opção de acordo com onde você quer que a renderização aconteça. Nenhuma delas substitui o writeHtml(), o pipeline de HTML em PHP puro embutido no motor principal.

composer require nextpdf/artisan

Este pacote adiciona renderização com headless Chrome por meio do Chrome DevTools Protocol (CDP). Você também precisa de um binário do Chrome ou Chromium acessível pelo host. Após a instalação, chame writeHtmlChrome() em um documento. Consulte o quickstart do Artisan.

composer require nextpdf/cloudflare guzzlehttp/guzzle

A renderização ocorre por meio do Cloudflare Browser Rendering na edge. A ponte depende apenas dos contratos PHP Standards Recommendation (PSR) PSR-18 e PSR-17, portanto você fornece seu próprio cliente Hypertext Transfer Protocol (HTTP) (o Guzzle é mostrado aqui). Consulte o guia de instalação do Cloudflare.

composer require nextpdf/gotenberg guzzlehttp/guzzle

Este pacote converte documentos office e HTML por meio de um serviço Gotenberg. Você fornece um cliente PSR-18 e uma instância do Gotenberg acessível. Consulte o guia de instalação do Gotenberg.

Instalar o servidor

O NextPDF Server (também chamado de Connect) é um serviço standalone. Ele expõe o motor por Model Context Protocol (MCP), Representational State Transfer (REST) e gRPC.

composer require nextpdf/server

O pacote adiciona pontos de entrada de console em vendor/bin/, incluindo vendor/bin/nextpdf-mcp (o servidor stdio MCP) e vendor/bin/nextpdf-server (o servidor REST). Os transportes REST e gRPC também exigem o binário do RoadRunner:

./vendor/bin/rr get-binary

Consulte o guia de instalação do Connect e o quickstart do Connect.

Instalar o SDK para Python

O SDK para Python é o cliente tipado para um NextPDF Server em execução. Instale-o a partir do Python Package Index (PyPI):

pip install nextpdf

O SDK precisa do Python 3.10 ou mais recente e de um endpoint acessível do NextPDF Server. Consulte o quickstart do SDK para Python.

Verificar a instalação

Confirme que cada distribuição foi instalada corretamente antes de começar a escrever código.

composer show nextpdf/core

Uma linha de versão confirma que o motor está instalado e disponível para o autoloader.

php artisan package:discover --ansi

A saída lista o nextpdf/laravel entre os pacotes descobertos.

php bin/console debug:container nextpdf

O container reporta o alias nextpdf.document e o serviço PdfFactory.

./vendor/bin/generate-skills --dry-run --list-tools

Isso inicializa o registry e imprime as ferramentas expostas por esta instalação sem iniciar um servidor.

nextpdf version

Uma string de versão confirma que o SDK é importado sem problemas.

Veja também

Seu primeiro PDF Gere um PDF a partir do PHP e renderize HTML para PDF.

Escolha o seu caminho Decida qual distribuição e qual renderizador de HTML se ajustam à sua aplicação.

Integrações O mapa completo de extensões e o guia de seleção.

Connect (servidor) Execute o motor como um serviço de rede por MCP, REST e gRPC.