PHP tarifleri

Tarifler / kılavuzlar, üst akış depoları yayımlandıkça buraya eklenir. Bu sayfa, kaynak depolarda yazılan içerik için bir yönlendirme dizinidir (nextpdf, nextpdf-Laravel, nextpdf-Symfony ve diğer ekosistem paketleri). Şu anda mevcut olan belgeler için Insider_ (35 makale, 17 yerel ayarın tümü) ya da Bir entegrasyon seçin sayfasına bakın.

PHP Cookbook

Bu dizin, PHP’ye özgü NextPDF tariflerini listeler: doğrudan çekirdek PHP API’sini kullanan, göreve odaklı, çalıştırılabilir sayfalar. nextpdf çekirdek deposu her tarifin sahibidir ve her birini docs/public/cookbook/php/ altında doğrular. Her tarifin bir examples/*.php betiği ve bir tests/Cookbook/Php/ test düzeneği vardır. Toplayıcı daha sonra her sayfayı bu siteye çeker ve kaynak kökenini korur.

Bu sayfa bir dizin olduğundan, herhangi bir tarif hakkında davranışsal iddiada bulunmaz. Her satır, tarifin amacını, kullandığı çekirdek modülü ve beyan ettiği yeniden üretilebilirlik profilini kaydeder. Profil ve uygunluk iddiaları, tarif sayfasının kendisine aittir. Bunlar, bu dizinden değil, o sayfanın ön bilgisinden (front-matter) ve depo içi testinden gelir. Entegrasyon (çerçeve / işleyici / hizmet) Cookbook’u için Entegrasyon Cookbook sayfasına bakın. Çalıştırılabilir her tarifin uyduğu sözleşme için Tarif kuralları sayfasına bakın.

Bir tarif bağlantısı nasıl çözümlenir

Aşağıdaki her [[…]], çekirdek deposunda docs/public/cookbook/php/ altında yazılmış bir sayfaya yapılan ileriye dönük bir başvurudur. Toplayıcı daha sonra o sayfayı bu siteye çeker. Her bilgi etiketi (slug) tek bir kurala uyar: tek bölümden oluşur.

/cookbook/php/<recipe>/

<recipe>, tarifin amacını kebab-case biçiminde adlandırır (örneğin render-html-to-pdf, modül adı html değil). Küçük harflerle yazılır, tireyle ayrılır, sürüm numarası içermez ve tek bir sondaki eğik çizgiyle biter. Bir hedef sayfa toplanana kadar bağlantısı yer tutucudur ve çözümlenmez. Henüz çalıştırılabilir örneği olmayan bir tarif (aşağıdaki eksik tarifler listesi), bağlantısı zaten nihai bilgi etiketine işaret etse de, örneği ve test düzeneği hazır olana kadar yayımlanamaz.

Tek satırda yeniden üretilebilirlik profili

Her tarif, gerçekte karşılayabileceği en katı profili beyan eder:

• bitwise — çalıştırmalar arasında bayt düzeyinde aynıdır (tüm entropisi sabitlenmiş, tamamen belirlenimci içerik).
• structural — değişken atomlar normalleştirildikten sonra aynıdır (sonlandırıcıdaki /ID, creation/modification tarihleri, yazı tipi alt küme önekleri — uygulamada, birden çok nesne içeren her PDF).
• semantic — yalnızca yapısal-AST ve meta veri eşdeğerliği (imzalı veya zaman damgalı çıktı ya da eşdeğerliği doğası gereği bayt düzeyinde kararlı olmayan çıktı).

Tarif sayfası, profili test düzeneğiyle kanıtlar. Bu dizin yalnızca o sayfanın beyan ettiği değeri bildirir.

Hâlihazırda toplanan tarifler

Çekirdek deposu şu anda bu beş tarifi barındırır ve birleştirir: Wave 8 kümesi.

Tarif	Ne yapar	Modül	Profil
sign-pades (üst akışta planlandı)	Bir yazılım anahtarıyla temel CMS/PAdES imzası uygulayın	Güvenlik	semantic
encrypt-aes256 (üst akışta planlandı)	AES-256 ile şifreleyin ve izin bayraklarını ayarlayın	Güvenlik	structural
pdfa4-conformance-gate (üst akışta planlandı)	PDF/A-4 çıktısı üretin ve harici bir doğrulayıcıyla geçit denetimi uygulayın	Uygunluk	semantic
accessible-pdfua2-from-html (üst akışta planlandı)	Erişilebilir PDF/UA-2 oluşturma için etiketli yapı üretin	Erişilebilirlik	semantic
validate-signature (üst akışta planlandı)	Bir PDF’nin imza taşıyıp taşımadığını ve güven sınırını inceleyin	İnceleme	semantic

Temeller

Bir belge oluşturun, sayfalara bölün ve biçimlendirin.

Tarif	Ne yapar	Modül	Profil
render-html-to-pdf (üst akışta planlandı)	Bir HTML belgesini PDF olarak işleyin	Html	structural
style-with-css (üst akışta planlandı)	Bir HTML işleme sürecine CSS uygulayın	Html	structural
html-table-layout (üst akışta planlandı)	Bir HTML tablosunu yerleştirin	Html	structural
paginate-long-html (üst akışta planlandı)	Uzun bir HTML belgesini sayfalara bölün	Html	structural
compose-text-and-fonts (üst akışta planlandı)	Metni tipografik denetimle oluşturun	Tipografi	structural
embed-and-subset-fonts (üst akışta planlandı)	Yazı tiplerini gömün ve alt kümelerini oluşturun	Font	structural
cjk-vertical-writing (üst akışta planlandı)	CJK metnini dikey yazım modunda dizin	Tipografi	structural
multi-page-document (üst akışta planlandı)	Çok sayfalı bir belge oluşturun	Belge	structural
headers-and-footers (üst akışta planlandı)	Yinelenen üst bilgiler ve alt bilgiler ekleyin	Yerleşim	structural

Grafik ve içerik

Vektörler, görüntüler, katmanlar ve koordinat alanıyla çalışın.

Tarif	Ne yapar	Modül	Profil
draw-vector-graphics (üst akışta planlandı)	Vektör grafikleri çizin	Grafik	structural
gradients-and-transparency (üst akışta planlandı)	Gradyanlar ve saydamlık uygulayın	Grafik	structural
embed-images (üst akışta planlandı)	Raster görüntüleri gömün	İçerik	structural
optional-content-layers (üst akışta planlandı)	İsteğe bağlı içerikleri (katmanları) kullanın	Grafik	structural
transform-coordinate-space (üst akışta planlandı)	Koordinat alanını dönüştürün	Grafik	structural

Gezinme ve formlar

Yer imleri, bağlantılar, açıklama notları ve AcroForm alanları ekleyin.

Tarif	Ne yapar	Modül	Profil
bookmarks-and-toc (üst akışta planlandı)	Yer imleri ve içindekiler tablosu oluşturun	Gezinme	structural
links-and-annotations (üst akışta planlandı)	Bağlantılar ve açıklama notları ekleyin	Gezinme	structural
generate-barcodes (üst akışta planlandı)	Barkodlar oluşturun	Barkod	bitwise
fill-pdf-form (üst akışta planlandı)	Bir AcroForm’u doldurun	Form	structural
flatten-form-fields (üst akışta planlandı)	Form alanlarını düzleştirin	Form	structural

Belge bilgileri

Meta verileri ve görüntüleyici davranışını ayarlayın.

Tarif	Ne yapar	Modül	Profil
set-document-metadata (üst akışta planlandı)	Belge meta verilerini ayarlayın	Meta veri	structural
set-viewer-preferences (üst akışta planlandı)	Görüntüleyici tercihlerini ayarlayın	Belge	structural

Güvenlik, imza ve uygunluk

Şifreleme, imzalama, erişilebilirlik ve profil çıktısı kullanın. Bu tariflerde destek≠uygunluk ve varlık≠geçerlilik ayrımları tarif sayfasında tutulur.

Tarif	Ne yapar	Modül	Profil
encrypt-with-permissions (üst akışta planlandı)	İzin bayraklarıyla şifreleyin	Güvenlik	structural
sign-pades-b-b (üst akışta planlandı)	Bir PAdES imzası uygulayın (B-B ve B-T)	Güvenlik	semantic
inspect-existing-signature (üst akışta planlandı)	Mevcut bir imzayı inceleyin	İnceleme	semantic
tagged-pdf-ua2 (üst akışta planlandı)	PDF/UA-2 için etiketli yapı üretin	Erişilebilirlik	semantic
pdf-a-4-output (üst akışta planlandı)	PDF/A-4 çıktısı üretin	Uygunluk	semantic
validate-conformance (üst akışta planlandı)	Bir uygunluk profiline göre doğrulayın	Uygunluk	semantic

İnceleme ve ayıklama

Bir PDF’den içeriği ve yapıyı okuyup çıkarın.

Tarif	Ne yapar	Modül	Profil
extract-text-content (üst akışta planlandı)	Metin içeriğini ayıklayın	Metin	semantic
parse-and-inspect-pdf (üst akışta planlandı)	Bir PDF dosyasını ayrıştırın ve inceleyin	İnceleme	semantic
inspect-layout-boxes (üst akışta planlandı)	Yerleşim kutularını inceleyin	İnceleme	semantic

Kesişen konular

Birden çok modülü kapsayan desenleri kullanın.

Tarif	Ne yapar	Kapsadığı modüller	Profil
worker-safe-batch-rendering (üst akışta planlandı)	Uzun süre çalışan bir worker’da güvenli biçimde işleyin (paylaşılan kayıtlar, sınırlandırılmış bellek)	Core · Performance · Support	semantic
exception-aware-error-handling (üst akışta planlandı)	Hataları NextPDF’in istisna hiyerarşisiyle işleyin	Exception · Contracts	structural
observe-with-opentelemetry (üst akışta planlandı)	İşlemeyi OpenTelemetry ile gözlemleyin	Observability · Telemetry · Event	semantic

Çalıştırılabilir bir örnek bekleyen tarifler

Bu tariflerin yayımlanabilmesi için çekirdek deposunda yeni bir examples/*.php dosyasına ve bir tests/Cookbook/Php/ test düzeneğine ihtiyaç vardır. Yukarıdaki bilgi etiketi nihaidir. Sayfa, örnek eklenip testi çalışana kadar yer tutucu olarak kalır:

• sign-pades-b-b (üst akışta planlandı) (PAdES B-B ve B-T’yi kapsar)
• inspect-existing-signature (üst akışta planlandı)
• extract-text-content (üst akışta planlandı)
• parse-and-inspect-pdf (üst akışta planlandı)
• validate-conformance (üst akışta planlandı)
• inspect-layout-boxes (üst akışta planlandı)
• worker-safe-batch-rendering (üst akışta planlandı) (örnek mevcut; yeni bellek/GC test düzeneği eklendi)
• observe-with-opentelemetry (üst akışta planlandı) (yeni PHP’ye özgü örnek eklendi)

Yukarıdaki diğer tariflerin her birinde zaten destekleyici bir examples/*.php dosyası vardır ve yalnızca bir test sarmalayıcısına ihtiyaç duyulur. Bu dizin, bilgi etiketini ve nihai sayfayı kaydeder. Bekleyen herhangi bir sayfanın zaten tamamlandığını iddia etmez.

Ayrıca bakınız

• Entegrasyon Cookbook — çerçeve, işleyici ve hizmet entegrasyonu dizini.
• Tarif kuralları — bu Cookbook’taki çalıştırılabilir her tarifin uyduğu sözleşme.