Cookbook

Visão geral

Este cookbook é orientado a tarefas. Cada receita resolve um problema com um exemplo que você pode copiar e que é respaldado por código-fonte. As receitas são agrupadas em três famílias, conforme o local em que o trabalho é executado. Escolha a família que corresponde à forma como você chama o NextPDF e, em seguida, abra a receita de que precisa.

Quando quiser entender por que o engine se comporta de determinada forma, leia os Guides. Para consultar a interface de programação de aplicações (API) verificada, leia a Reference.

Um exemplo, um runtime

Cada receita tem um runtime como alvo. As receitas em PHP chamam o core engine no mesmo processo. As receitas do Connect chamam ferramentas por meio de um transporte. As receitas de integração conectam o NextPDF a um framework ou a um backend de renderizador. Leia a página de convenções correspondente antes de adaptar um exemplo.

Receitas em PHP

As receitas em PHP executam o core engine diretamente, no mesmo processo. Cada receita começa com composer require nextpdf/core e, em seguida, usa a API pública para criar, assinar, inspecionar ou converter documentos, incluindo Document::createStandalone() e writeHtml().

Receitas em PHP O mapa de toda receita nativa em PHP: renderizar HTML para PDF, dispor tabelas, embutir e criar subconjuntos de fontes, criptografar com AES-256, assinar com PAdES, emitir PDF/A-4 e PDF/UA-2 marcado, extrair texto e inspecionar arquivos existentes.

Receitas do Connect

As receitas do Connect chamam o NextPDF por meio do registro de ferramentas do servidor sobre o Model Context Protocol (MCP), Representational State Transfer (REST) ou gRPC. A mesma chamada de ferramenta funciona nos três transportes e continua sujeita ao portão de confirmação com humano no circuito (human-in-the-loop).

Receitas do Connect Receitas independentes de transporte para o servidor NextPDF Connect: hello world, tabelas HTML, incorporação de imagens, assinaturas digitais, verificações de acessibilidade e conformidade, redação, análise forense e observabilidade com OpenTelemetry.

Receitas de integração

As receitas de integração mostram como conectar o NextPDF a um framework de aplicação ou delegar a renderização a um backend externo. Elas abrangem adaptadores de framework, pontes de renderizador e o caminho de migração a partir de uma biblioteca legada.

Receitas de integração Receitas para os pacotes do ecossistema: escolher uma integração, retornar um PDF a partir de um controlador de framework, enfileirar a geração em um job em segundo plano, renderizar HTML com Artisan, converter arquivos do Office com Gotenberg, renderizar na borda com Cloudflare e seguir o caminho de migração do TCPDF.

Convenções de receita

Toda receita segue um contrato documentado: exemplos respaldados por código-fonte, front-matter de perfil de reprodutibilidade, um limite honesto de conformidade e o portão de publicação. Leia a página de convenções da família de receitas antes de adaptar um exemplo.

Convenções de receita de integração O contrato que toda receita de integração executável segue: exemplos respaldados por código-fonte, front-matter de perfil de reprodutibilidade e o portão de publicação.

Convenções de receita do Connect O contrato que toda receita do Connect segue: chamadas de ferramenta independentes de transporte, ferramentas condicionadas ao tier, o modelo de risco e o portão de confirmação, e o limite de conformidade honesto.

Veja também

• Guides — documentação conceitual e prática.
• Reference — a API verificada e a matriz de suporte a Cascading Style Sheets (CSS).
• Escolha uma integração — uma matriz de decisão que mapeia casos de uso para integrações.