Ortak

Bir bakışta

NextPDF Enterprise, Enterprise modülleri genelinde yeniden kullanılan küçük bir paylaşılan ilkeller kümesi sunar. İlki, çözünürlükten bağımsız uzamsal konumlandırma için normalleştirilmiş bir sınırlayıcı kutudur. Bunlar; hiçbir uyumluluk, uygunluk veya kriptografik davranışı olmayan değer nesneleridir.

Kullanılabilirlik ve lisanslama

Bu yetenek NextPDF Enterprise (nextpdf/enterprise) içinde sunulur ve bir Enterprise katmanı lisans zarfıyla etkinleşir. Bu yetkilendirme olmadan yapılan bir dağıtım, yeteneğin sınıflarını yüklemez. Sürümleri karşılaştırın ve bir lisans alın.

Enterprise paketi, Core paketinin yanına kurulur; bu paylaşılan ilkeller, diğer Enterprise modülleri tarafından dahilî olarak tüketilir ve paketle çözümlenir. Hiçbir Core katmanı veya Pro katmanı eşdeğerleri yoktur.

Kurulum

composer require nextpdf/enterprise:^3

Kavramsal genel bakış

BoundingBox, dört koordinatı — x, y, genişlik, yükseklik — sayfa boyutlarına göre [0.0, 1.0] aralığına normalleştirilmiş, değişmez bir değer nesnesidir. Koordinatlar normalleştirildiğinden kutu çözünürlükten bağımsızdır ve sayfa geometrisi üzerinde akıl yürüten Enterprise modülleri genelinde yeniden kullanılabilir. Yapıcı, her koordinatın aralık içinde olduğunu ve x + width ile y + height değerlerinin 1.0’ı aşmadığını (küçük bir kayan nokta toleransı dâhilinde) doğrular; aksi hâlde bir bağımsız değişken hatası yükseltir.

area(), contains(self $other) ve overlaps(self $other) açığa çıkarır. Sıfır alanlı kutular (yozlaşmış noktalar veya çizgiler) tanım gereği örtüşemez.

Bu modülün ileri sürdüğü

Bu modül doğrulanmış geometri ilkelleri sağlar. Hiçbir uyumluluk veya uygunluk iddiasında bulunmaz ve hiçbir G/Ç gerçekleştirmez.

Katman sınırı

Common, diğer Enterprise modüllerinin tükettiği yalnızca Enterprise’a özgü bir destek yüzeyidir. Core geometrisini çoğaltmaz veya değiştirmez; Enterprise modüllerinin paylaştığı küçük, doğrulanmış ilkelleri sağlar.

Neden bu şekilde çalışır

Yük taşıyan karar, her koordinatı [0.0, 1.0] aralığına normalleştirmek ve yapıcıda doğrulamaktır. Normalleştirilmiş koordinatlar kutuyu çözünürlükten bağımsız kılar, böylece bir kez tanımlanan bir bölge herhangi bir sayfa boyutunda veya işleme ölçeğinde doğru kalır. Başarısızlıkta kapanan yapım, geçersiz veya taşan bir kutunun var olamayacağı anlamına gelir: yapıcı, kırpma veya tahmin yürütme yerine onu reddeder. Bu nedenle tüketen Enterprise modülleri, aldıkları geometriyi asla yeniden denetlemez; çünkü oluşturulmuş bir kutu zaten geçerli olarak bilinir. Değişmezlik, paylaşılan bir kutunun savunmacı kopyalar olmadan modüller arasında geçirilmesini güvenli kılar. Tasarım arka planı: Tahmin yürütmeyi reddeden bir API.

API yüzeyi

Sınıf	Sorumluluk
BoundingBox	Değişmez normalleştirilmiş kutu; area(), contains(), overlaps().

Kod örneği — hızlı başlangıç

use NextPDF\Enterprise\Common\BoundingBox;

$box = new BoundingBox(0.1, 0.1, 0.5, 0.2);
$inside = $box->contains(new BoundingBox(0.2, 0.15, 0.1, 0.02));

Kod örneği — üretim

$region = new BoundingBox($x, $y, $w, $h); // throws on out-of-range input

if ($region->overlaps($redactionZone)) {
    $logger->info('common.overlap', ['area' => $region->area()]);
}

Uç durumlar ve tuzaklar

• [0.0, 1.0] dışında herhangi bir koordinatla veya x + width / y + height değeri 1.0’ı aşan bir koordinatla oluşturmak bir bağımsız değişken hatası yükseltir — girdileri yukarı akışta doğrulayın.
• Sıfır alanlı kutular asla örtüşmez; kesişimleri hesaplarken bunu hesaba katın.
• Koordinatlar piksel değil, normalleştirilmiştir; işleme sınırında dönüştürün.

Performans

Tüm işlemler, dört kayan nokta üzerinde sabit zamanlı aritmetiktir.

Güvenlik notları

BoundingBox hiçbir G/Ç gerçekleştirmez ve hiçbir belge içeriği tutmaz. Yapıcı, aralık dışı geometriyi reddederek yozlaşmış değerlerin tüketen modüllere yayılmasını önler.

Veri yerleşimi ve PII azaltmaları

Bu modül hiçbir kişisel veri tutmaz ve hiçbir kalıcılık veya ağ G/Ç’si gerçekleştirmez. Yerleşim değerlendirmeleri uygulanmaz.

Güvenli telemetri ve günlük temizleme

Kutu koordinatları ve alanları hassas olmayan geometridir ve günlüğe kaydedilmesi güvenlidir.

Uygunluk

Bu modül hiçbir normatif standart uygulamaz ve hiçbir uygunluk iddiasında bulunmaz. Bir geometri ilkelidir.

FIPS modu davranışı

Bu modül hiçbir kriptografik işlem gerçekleştirmez; FIPS modu uygulanmaz.

Tehdit modeli

Tek girdi dört kayan noktadır. Yapıcının aralık ve sınır doğrulaması, önlemdir: geçersiz geometri oluşturulamaz.

Davranış sözleşmesi

• BoundingBox, dört koordinatı sayfa boyutlarına göre [0.0, 1.0] aralığına normalleştirilmiş, onu çözünürlükten bağımsız kılan değişmez bir değer nesnesidir.
• Yapıcı, her koordinatın aralık içinde olduğunu ve x + width ile y + height değerlerinin 1.0’ı aşmadığını (küçük bir kayan nokta toleransı dâhilinde) doğrular; aksi hâlde bir bağımsız değişken hatası yükseltir.
• area(), contains() ve overlaps() açığa çıkarır; sıfır alanlı kutular tanım gereği asla örtüşmez.
• Modül hiçbir G/Ç gerçekleştirmez, hiçbir belge içeriği tutmaz ve hiçbir uyumluluk veya uygunluk iddiasında bulunmaz.

Yayımlama sınırı

Bu sayfa yalnızca dışarıdan gözlemlenebilir davranışı ve desteklenen genel API yüzeyini belgeler. Dahilî ad alanı yolları, yardımcı sınıflar, mekanizma tabloları, runbook dosya adları ve bilet önekleri kapsam dışıdır.

Core yedeği

Core yedeği — hiçbiri; bu, yalnızca Enterprise’a özgü bir paylaşılan destek ilkelidir. Core geometrisini çoğaltmaz veya değiştirmez ve hiçbir Core katmanı eşdeğeri yoktur.

Pro yedeği

Pro yedeği — hiçbiri; bu yeteneğin hiçbir Pro katmanı eşdeğeri yoktur. Paylaşılan BoundingBox ilkeli yalnızca nextpdf/enterprise paketinde sunulur.

Enterprise sınır notu

Doğrulanmış geometri ilkeli, davranış düzeyinde açıklanmıştır. Diğer Enterprise modüllerinin tükettiği yalnızca Enterprise’a özgü bir destek yüzeyidir; belgelenen sözleşmenin ötesinde hiçbir dahilî alt mekanizma yoktur.

Dağıtım sınırı

Dağıtım sınırı — uygulanabilir hiçbiri; bu modül hiçbir kalıcılık, hiçbir ağ G/Ç’si gerçekleştirmez ve hiçbir belge içeriği ya da kişisel veri tutmaz. Bu yüzey için operatöre ait hiçbir kaynak yoktur.

Hukuki uyumluluk sınırı

Bu yüzeye hiçbir ihracat denetimi kısıtlaması uygulanmaz. Modül hiçbir normatif standart uygulamaz ve hiçbir uygunluk, sertifikasyon veya düzenleyici iddiada bulunmaz. Bu belge bir hukuki görüş değildir.

Ayrıca bakınız

• Validation — paylaşılan ilkelleri tüketir.
• Evidence — paylaşılan ilkelleri tüketir.
• Common — Derinlemesine Referans — paylaşılan ilkeller için derinlemesine referans.