Por qué construimos sobre Cloudflare
De un vistazo
Sección titulada «De un vistazo»El paquete nextpdf/cloudflare permite que
NextPDF renderice PDF en el edge, archive los archivos generados en R2 y filtre
las solicitudes de API antes de que lleguen a un worker. Las demás páginas de
esta sección explican exactamente cómo. Esta es distinta: es la razón breve y
honesta por la que nos emocionó construirlo, y un agradecimiento.
Por qué Cloudflare
Sección titulada «Por qué Cloudflare»Lo diremos sin rodeos: al equipo de NextPDF le encanta construir sobre Cloudflare. Es una plataforma a la que recurrimos con gusto, y su capa gratuita realmente generosa es buena parte del porqué. Para nosotros esa generosidad no es algo accesorio: es lo que permite a un equipo pequeño devolver más a la comunidad de código abierto de lo que podría en otras circunstancias; más motor mantenido abierto, más tiempo dedicado a las partes de las que todos se benefician, y menos decisiones marcadas por el coste de la infraestructura en lugar del bien del proyecto. Cuando una plataforma baja el listón así, el trabajo que se construye encima puede ser más ambicioso.
Qué se vuelve posible
Sección titulada «Qué se vuelve posible»Esta es la parte que de verdad nos entusiasma compartir, porque creemos que abre puertas. Con NextPDF sobre Cloudflare, tu aplicación PHP se queda con el HTML y un Cloudflare Worker se queda con el navegador headless: el puente envía el marcado y recibe de vuelta los bytes del PDF renderizado, de modo que ningún Chromium headless tiene que ejecutarse dentro de tu proceso PHP. A partir de ahí puedes archivar los archivos generados en R2 y devolver URL firmadas, y filtrar las solicitudes de API entrantes a nivel del paquete antes de que lleguen siquiera a tu worker.
Es un paquete pequeño que hace bien un trabajo concreto, y lo construimos con cuidado. Pero la razón por la que no podíamos esperar a ponerlo en tus manos no es el código: es la pregunta que hay detrás. Cuando un motor de PDF tan capaz se encuentra con una plataforma tan capaz, ¿qué cosas más profundas, más amplias y más interesantes construye la gente? No creemos haberlas imaginado todas. Ese es, precisamente, el punto. Empieza por la introducción o por la guía rápida y mira hasta dónde te lleva.
Construido con cuidado
Sección titulada «Construido con cuidado»Enviar HTML fuera de tu proceso para renderizarlo en otro lugar es una frontera de confianza, y la tratamos como tal. El puente valida a dónde se le permite ir a una solicitud antes de enviar nada, en el espíritu de la guía de OWASP sobre la falsificación de solicitudes del lado del servidor, y su transporte puede fijar (pin) la clave pública exacta que espera ver (RFC 7469). Los detalles —validación de URL, límites de tamaño, pinning y controles de R2— están en Seguridad y operaciones de Cloudflare.
Gracias, Cloudflare
Sección titulada «Gracias, Cloudflare»Dicho sin rodeos: gracias. Una capa gratuita generosa y una plataforma fiable nos facilitaron mantener NextPDF abierto, y les facilitaron a los desarrolladores que leen esto intentar algo ambicioso sin que la factura lo decida primero.
Este mismo sitio de documentación se sirve sobre Cloudflare, así que, si lo estás leyendo ahora, lo estás viendo en la práctica.
Consulta también
Sección titulada «Consulta también»- NextPDF Cloudflare: la sección completa.
- Introducción: qué hace el puente y cuáles son sus límites.
- Guía rápida: tu primer PDF renderizado en el edge.
- Seguridad y operaciones de Cloudflare: la frontera de confianza en detalle.
Cloudflare, y nombres de producto relacionados como Cloudflare Workers y R2, son marcas comerciales de Cloudflare, Inc., usadas aquí únicamente para describir cómo NextPDF interopera con la plataforma. NextPDF es un proyecto independiente sin afiliación corporativa con Cloudflare, Inc., y no cuenta con el respaldo ni el patrocinio de Cloudflare.