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.

Um motor, várias portas de entrada

O motor principal é o nextpdf/core. Integrações com frameworks, renderizadores de Hypertext Markup Language (HTML), o servidor e o cliente Python adicionam, cada um, um pacote complementar. Nenhum deles substitui o motor principal; eles o instalam para você.

Requisitos

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

Requisitos de tempo de execução do NextPDF, lidos dos próprios arquivos composer.json dos pacotes

Requisito	Restrição	Status	Notas
PHP	>=8.4 <9.0	Obrigatório	O Composer se recusa a instalar no PHP 8.3 ou inferior, ou no PHP 9.
Composer	2.x	Obrigatório	Necessário para resolução de dependências e geração do autoloader.
ext-mbstring	—	Obrigatório	Manipulação de strings multibyte para layout de texto.
ext-zlib	—	Obrigatório	Compressão de fluxo para objetos do Portable Document Format (PDF).
ext-intl	—	Obrigatório	Serviços do International Components for Unicode (ICU): texto bidirecional, quebra de linha e formatação sensível à localidade.
ext-gd	—	Obrigatório	Decodificação e processamento de imagens raster para imagens incorporadas.
ext-curl	—	Obrigatório	Idas e voltas na rede: carimbo de data/hora RFC 3161 e buscas de ativos remotos. A geração offline não o utiliza, mas o Composer ainda assim o exige.
ext-openssl	—	Obrigatório	Criptografia para assinaturas digitais, estruturas CMS e encriptação.
Chrome or Chromium	—	Opcional	Somente para o renderizador do Artisan (writeHtmlChrome()).
Gotenberg service	—	Opcional	Somente para conversão de office e HTML por meio do Gotenberg.
Python	3.10+	Opcional	Somente para o software development kit (SDK) do Python.

ext-mbstring e ext-zlib vêm habilitadas na maioria dos builds de PHP; ext-intl, ext-gd, ext-curl e ext-openssl variam conforme a distribuição, portanto verifique todas as seis com php -m antes de instalar. As integrações verificam as extensões de que precisam 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ê.

Laravel

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.

Symfony

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.

CodeIgniter

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.

Artisan (Chrome)

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.

Cloudflare

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.

Gotenberg

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.

Renderizadores vão além do PHP

O Artisan inicia um processo de navegador, enquanto o Cloudflare e o Gotenberg chamam um serviço de rede. Trate o HTML como não confiável. Leia a página de segurança e operações de cada pacote antes de renderizar entradas influenciadas por usuários.

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.

Core / PHP

composer show nextpdf/core

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

Laravel

php artisan package:discover --ansi

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

Symfony

php bin/console debug:container nextpdf

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

Server

./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.

Python

nextpdf version

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

Veja também

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

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

Compra e licenciamentoCompre uma licença Pro ou Enterprise por meio do nosso Merchant of Record, depois instale e ative.

IntegraçõesO 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.