Por que construímos na Cloudflare

Em resumo

O pacote nextpdf/cloudflare permite ao NextPDF renderizar PDFs na edge, arquivar os arquivos gerados no R2 e filtrar requisições de API antes que elas cheguem a um worker. As outras páginas desta seção mostram exatamente como. Esta aqui é diferente: é o motivo curto e sincero pelo qual ficamos tão animados para construí-lo — e um obrigado.

Por que a Cloudflare

Vamos dizer sem rodeios: o time do NextPDF adora construir na Cloudflare. É uma plataforma à qual recorremos com gosto, e seu plano gratuito de fato generoso é boa parte do porquê. Essa generosidade não é um detalhe para nós — é o que permite a um time pequeno devolver mais à comunidade open source do que conseguiria de outra forma: mais do motor mantido aberto, mais tempo dedicado às partes que beneficiam todo mundo e menos decisões movidas pelo custo da infraestrutura em vez do bem do projeto. Quando uma plataforma baixa o piso desse jeito, o trabalho que vem por cima pode ser mais ambicioso.

O que se torna possível

Esta é a parte que estamos realmente animados para compartilhar, porque achamos que ela abre portas. Com o NextPDF na Cloudflare, sua aplicação PHP guarda o HTML e um Cloudflare Worker guarda o navegador headless: a ponte envia a marcação para fora e recebe de volta os bytes do PDF renderizado, de modo que nenhum Chromium headless precisa rodar dentro do seu processo PHP. A partir daí, você pode arquivar os arquivos gerados no R2 e devolver URLs assinadas, além de filtrar as requisições de API que chegam já no nível do pacote, antes mesmo que elas alcancem o seu worker.

É um pacote pequeno fazendo bem um trabalho focado, e o construímos com cuidado. Mas o motivo pelo qual mal podíamos esperar para colocá-lo nas suas mãos não é o código — é a pergunta por trás dele: quando um motor de PDF tão capaz encontra uma plataforma tão capaz, que coisas mais profundas, mais amplas e mais interessantes as pessoas constroem? Não achamos que imaginamos todas elas. E esse é justamente o ponto. Comece pela visão geral ou pelo guia rápido e veja aonde isso te leva.

Feito com cuidado

Enviar HTML para fora do seu processo para ser renderizado em outro lugar é uma fronteira de confiança, e a tratamos como tal. A ponte valida para onde uma requisição tem permissão de ir antes de enviar qualquer coisa, no espírito da orientação da OWASP sobre server-side request forgery, e seu transporte pode fixar a exata chave pública que espera encontrar (RFC 7469). Os detalhes — validação de URL, limites de tamanho, pinning e controles do R2 — estão em Segurança e operações do Cloudflare.

Obrigado, Cloudflare

Sem rodeios, então: obrigado. Um plano gratuito generoso e uma plataforma confiável tornaram mais fácil para nós manter o NextPDF aberto, e mais fácil para os desenvolvedores que leem isto experimentar algo ambicioso sem que a conta decidisse por eles primeiro.

Este próprio site de documentação é servido na Cloudflare — então, se você está lendo isto agora, está vendo isso na prática.

Veja também

Integração com a Cloudflare — a seção completa.
Visão geral — o que a ponte faz e seus limites.
Guia rápido — seu primeiro PDF renderizado na edge.
Segurança e operações do Cloudflare — a fronteira de confiança em detalhe.

Cloudflare e nomes de produtos relacionados, como Cloudflare Workers e R2, são marcas registradas da Cloudflare, Inc., usadas aqui apenas para descrever como o NextPDF interopera com a plataforma. O NextPDF é um projeto independente, sem afiliação corporativa com a Cloudflare, Inc., e não é endossado nem patrocinado pela Cloudflare.