Neden Cloudflare üzerinde geliştiriyoruz

Kısa bir bakış

nextpdf/cloudflare paketi, NextPDF’in PDF’leri uçta işlemesini, oluşturulan dosyaları R2’ye arşivlemesini ve API isteklerini bir worker’a ulaşmadan önce denetlemesini sağlar. Bu bölümdeki diğer sayfalar bunun tam olarak nasıl yapıldığını anlatıyor. Bu sayfa ise farklı: bunu geliştirmeye en baştan neden bu kadar hevesli olduğumuzun kısa, dürüst hikâyesi — ve bir teşekkür.

Neden Cloudflare

Açıkça söyleyelim: NextPDF ekibi Cloudflare üzerinde geliştirmeyi seviyor. Gönül rahatlığıyla başvurduğumuz bir platform ve bunun büyük bir nedeni de gerçekten cömert ücretsiz katmanı. Bu cömertlik bizim için önemsiz bir ayrıntı değil — küçük bir ekibin açık kaynak topluluğuna, aksi hâlde verebileceğinden çok daha fazlasını geri vermesini sağlayan şey tam da bu: motorun daha büyük bir bölümünün açık kalması, herkesin yararlandığı kısımlara daha çok zaman ayrılması ve projenin iyiliğinden çok altyapının maliyetiyle şekillenen daha az karar. Bir platform işin eşiğini bu kadar aşağı çektiğinde, onun üzerine kurulan iş de daha iddialı olabiliyor.

Nelerin mümkün olduğu

Bu kısmı paylaşmaya gerçekten heyecanlanıyoruz, çünkü yeni kapılar açtığını düşünüyoruz. NextPDF’i Cloudflare üzerinde çalıştırdığınızda, PHP uygulamanız HTML’i, bir Cloudflare Worker’ı ise başsız tarayıcıyı tutar: köprü işaretlemeyi dışarı gönderir ve işlenmiş PDF baytlarını geri alır; böylece PHP işleminizin içinde hiç başsız Chromium çalıştırmanız gerekmez. Oradan, oluşturulan dosyaları R2 üzerine arşivleyip imzalı URL’ler verebilir ve gelen API isteklerini worker’ınıza hiç ulaşmadan önce paket düzeyinde denetleyebilirsiniz.

Odaklı bir işi iyi yapan küçük bir paket bu ve onu özenle geliştirdik. Ama onu bir an önce sizin ellerinize bırakmak istememizin nedeni kodun kendisi değil — ardındaki soru şu: bu kadar yetenekli bir PDF motoru bu kadar yetenekli bir platformla buluştuğunda, insanlar daha derin, daha geniş, daha ilginç neler inşa eder? Bunların hepsini hayal edebildiğimizi sanmıyoruz. Zaten mesele de bu. Genel bakış ya da hızlı başlangıç sayfasından başlayın ve sizi nereye götüreceğini görün.

Özenle geliştirildi

HTML’i başka bir yerde işlenmek üzere işleminizin dışına göndermek bir güven sınırıdır ve biz de ona öyle yaklaştık. Köprü, herhangi bir şey göndermeden önce bir isteğin nereye gitmesine izin verildiğini doğrular — sunucu tarafı istek sahteciliğine dair OWASP kılavuzunun ruhuna uygun biçimde — ve aktarım katmanı, görmeyi beklediği tam genel anahtarı sabitleyebilir (RFC 7469). Ayrıntılar — URL doğrulama, boyut sınırları, sabitleme ve R2 denetimleri — Güvenlik ve operasyonlar sayfasında yer alıyor.

Teşekkürler, Cloudflare

Açıkça söyleyelim öyleyse: teşekkürler. Cömert bir ücretsiz katman ve güvenilir bir platform, NextPDF’i açık tutmamızı ve bu satırları okuyan geliştiricilerin faturanın kararı vermesine izin vermeden iddialı bir şey denemesini kolaylaştırdı.

Bu belge sitesinin kendisi de Cloudflare üzerinde sunuluyor — yani şu anda onu okuyorsanız, bunu iş başında görüyorsunuz demektir.

Ayrıca bkz.

NextPDF Cloudflare — bölümün tamamı.
Genel bakış — köprünün ne yaptığı ve sınırları.
Hızlı başlangıç — uçta işlenen ilk PDF’iniz.
Güvenlik ve operasyonlar — güven sınırı ayrıntılı olarak.

Cloudflare ve Cloudflare Workers ile R2 gibi ilgili ürün adları, Cloudflare, Inc. kuruluşunun ticari markalarıdır; burada yalnızca NextPDF’in platformla nasıl birlikte çalıştığını açıklamak için kullanılmıştır. NextPDF, Cloudflare, Inc. ile hiçbir kurumsal bağı bulunmayan bağımsız bir projedir ve Cloudflare tarafından onaylanmamış veya desteklenmemektedir.