PHP tarifleri

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.

Tarif bilgi etiketleri nasıl düzenlenir

Her tarif, çekirdek deposunda docs/public/cookbook/php/ altında yazılır ve toplayıcı tarafından bu siteye yayımlanır. 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.

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.

Temeller

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

Tarif	Ne yapar	Modül	Profil
render-html-to-pdf	Bir HTML belgesini PDF olarak işleyin	Html	structural
style-with-css	Bir HTML işleme sürecine CSS uygulayın	Html	structural
html-table-layout	Bir HTML tablosunu yerleştirin	Html	structural
paginate-long-html	Uzun bir HTML belgesini sayfalara bölün	Html	structural
paginate-large-html-tables	Büyük bir HTML tablosunu sayfalara bölün	Html	structural
render-rtl-arabic-html	Sağdan sola Arapça HTML işleyin	Html	structural
compose-text-and-fonts	Metni tipografik denetimle oluşturun	Tipografi	structural
embed-and-subset-fonts	Yazı tiplerini gömün ve alt kümelerini oluşturun	Font	structural
cjk-vertical-writing	CJK metnini dikey yazım modunda dizin	Tipografi	structural
multi-page-document	Çok sayfalı bir belge oluşturun	Belge	structural
headers-and-footers	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	Vektör grafikleri çizin	Grafik	structural
gradients-and-transparency	Gradyanlar ve saydamlık uygulayın	Grafik	structural
embed-images	Raster görüntüleri gömün	İçerik	structural
add-watermarks-and-backgrounds	Sayfalara metin ve görüntü filigranları ya da arka planlar ekleyin	İçerik	structural
cmyk-spot-color-and-icc-profiles	Baskıya hazır CMYK ve spot renk üretin	Renk	structural
embed-file-attachments	Dosyaları gömün ve PDF portföyleri oluşturun	İçerik	structural
optional-content-layers	İsteğe bağlı içerikleri (katmanları) kullanın	Grafik	structural
transform-coordinate-space	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	Yer imleri ve içindekiler tablosu oluşturun	Gezinme	structural
generate-dynamic-table-of-contents	Dinamik bir içindekiler tablosu oluşturun	Gezinme	structural
links-and-annotations	Bağlantılar ve açıklama notları ekleyin	Gezinme	structural
generate-barcodes	Barkodlar oluşturun	Barkod	bitwise
gs1-composite-barcodes	GS1 Composite barkodları (CC-C taşıyıcı) oluşturun	Barkod	structural
fill-pdf-form	Bir AcroForm’u doldurun	Form	structural
flatten-form-fields	Form alanlarını düzleştirin	Form	structural
form-field-validation-and-flatten-with-state	Form alanlarını doğrulayın ve durumuyla birlikte 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	Belge meta verilerini ayarlayın	Meta veri	structural
set-viewer-preferences	Görüntüleyici tercihlerini ayarlayın	Belge	structural

Belge işlemleri

Mevcut belgeleri birleştirin, bölün ve iyileştirin.

Tarif	Ne yapar	Modül	Profil
merge-external-pdfs	Harici PDF’leri birleştirin ya da sayfalar ekleyin	Belge	structural
split-and-extract-pages	Bir PDF’yi bölün ve sayfa aralıklarını ayıklayın	Belge	structural
optimize-pdf-file-size	Sıkıştırma ve alt kümeleme ile PDF dosya boyutunu küçültü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-aes256	AES-256 ile şifreleyin ve izin bayraklarını ayarlayın	Güvenlik	structural
encrypt-with-permissions	İzin bayraklarıyla şifreleyin	Güvenlik	structural
sign-pades-b-b	Bir PAdES imzası uygulayın (B-B ve B-T)	Güvenlik	semantic
inspect-existing-signature	Mevcut bir imzayı inceleyin	İnceleme	semantic
tagged-pdf-ua2	PDF/UA-2 için etiketli yapı üretin	Erişilebilirlik	semantic
accessible-pdfua2-from-html	Erişilebilir PDF/UA-2 oluşturma için HTML’den etiketli yapı üretin	Erişilebilirlik	semantic
pdf-a-4-output	PDF/A-4 çıktısı üretin	Uygunluk	semantic
pdfa4-conformance-gate	PDF/A-4 çıktısı üretin ve harici bir doğrulayıcıyla geçit denetimi uygulayın	Uygunluk	semantic
validate-conformance	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	Metin içeriğini ayıklayın	Metin	semantic
multilingual-copy-paste-extraction	CJK ve Arapça PDF’leri kopyala-yapıştırda doğru hale getirin	Metin	structural
parse-and-inspect-pdf	Bir PDF dosyasını ayrıştırın ve inceleyin	İnceleme	semantic
inspect-layout-boxes	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	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
streaming-and-memory	Akış ve bellek kullanımını profilleyin	Performance	bitwise
exception-aware-error-handling	Hataları NextPDF’in istisna hiyerarşisiyle işleyin	Exception · Contracts	structural
custom-error-recovery-patterns	Özel hata kurtarma ve yeniden deneme stratejileri uygulayın	Exception	semantic
observe-with-opentelemetry	İşlemeyi OpenTelemetry ile gözlemleyin	Observability · Telemetry · Event	semantic

Yukarıdaki her tarif, çekirdek deposunda destekleyici bir examples/*.php betiği ve bir tests/Cookbook/Php/ test düzeneğiyle birlikte yayımlanır. Üst akışta yeni bir tarif yazıldığında, örneği ve testi eklenir eklenmez burada görünür.

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.