Markalama

Bir bakışta

Markalama alt sistemi, bir değerlendirme sırasında oluşturulan PDF’lere görünür değerlendirme markalaması uygular ve ücretli bir lisans altında hiçbir şey uygulamaz. nextpdf/enterprise paketinde teslim edilir, sürümler genelinde değerlendirme davranışını yönetir ve tamamen lisans tarafından yönlendirilir — uygulama kodu tarafından değil. Uçtan uca değerlendirme öyküsü için Deneme ve Değerlendirme Markalaması sayfasına bakın; bu sayfa, markalama alt sisteminin kendisini belgeler.

Kullanılabilirlik ve lisanslama

Bu yetenek NextPDF Enterprise (nextpdf/enterprise) içinde sunulur ve bir Enterprise katmanı lisans zarfıyla etkinleşir. Bu yetkilendirmeye sahip olmayan 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.

Çoğu Enterprise yüzeyinden farklı olarak, tüm sürümler genelinde — yalnızca Core’lu ve yalnızca Pro’lu dağıtımlar dâhil — değerlendirme davranışını yönettiği için kendine ait bir yetenek kodu, enterprise.branding, taşır. Markalama modu, çalışma zamanında imzalı lisans zarfından çözümlenir; onu seçen hiçbir uygulama bayrağı yoktur ve herhangi bir sürümdeki ücretli bir lisans BrandingMode::None değerine çözümlenir.

Kurulum

composer require nextpdf/enterprise:^3

Kavramsal genel bakış

Çalışma zamanı, BrandingMode ile modellenen iki durumlu bir markalama moduna sahiptir:

• None — değerlendirme markalaması yok. Ücretli ve normal çıktı asla değiştirilmez. Bu varsayılandır.
• EvaluationWatermark — oluşturulan PDF’lere görünür değerlendirme markalaması uygulanır.

BrandingStrategyFactory, modu bir stratejiye eşler: None için NullBrandingStrategy (hiçbir iş yapmaz ve hiçbir değişiklik üretmez) ve EvaluationWatermark için EvaluationBrandingStrategy. Modu, uygulama kodu değil, lisans durumu seçer. Ücretli bir lisans asla markalanmış çıktı üretmez; geçiş yapılacak bir üretim derlemesi ve değiştirilecek bir kod bayrağı yoktur.

Bu sayfa yalnızca çalışma zamanı davranışını açıklar. Hiçbir garanti ve uygunluk ya da hukuki geçerlilik hakkında hiçbir beyan içermez; değerlendirmeniz veya aboneliğiniz için geçerli olan koşullar, yalnızca lisans sözleşmenizle tanımlanır.

API yüzeyi

Kavram	Davranış
BrandingMode	İki durum: None (varsayılan, değişiklik yok) veya EvaluationWatermark.
BrandingStrategyFactory	Bir BrandingMode değerini bir stratejiye çözümler.
EvaluationBrandingStrategy	Değerlendirme filigranını ve meta veri süslemesini uygular.
NullBrandingStrategy	Ücretli / normal çıktı için işlemsiz strateji.
EvaluationBrandingConfig	Değişmez filigran metni, meta veri süslemesi, yazı tipi boyutu, gri düzeyi ve açı.
BrandingStrategy	Entegrasyon katmanının tükettiği sözleşme: isActive(), buildPageWatermark(), decorateProducer(), decorateSubject().
BrandingApplicator	Çözümlenmiş bir stratejiyi işlenmiş PDF baytlarına uygular; hataya-kapalı — etkin markalama işaretlenemediğinde BrandingApplicationException fırlatır.

Alt sistem, lisansın çözümlediği stratejiyi uygulayan entegrasyon katmanı için küçük bir çağrılabilir yüzey sunar; uygulama kodu asla markalanıp markalanmayacağını seçmez. Aşağıdaki örnekler iki temas noktasını gösterir: çözümlenmiş bir stratejiyi okuma ve işlenmiş baytları hataya-kapalı uygulayıcıyla işaretleme.

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

Lisansın seçtiği stratejiyi çözümleyin ve davranışını okuyun. Ücretli bir lisans BrandingMode::None değerine çözümlenir; bu değerin stratejisi etkin değildir ve her değeri değiştirmeden geçirir.

resolve-strategy.php

<?php

declare(strict_types=1);

use NextPDF\Enterprise\Branding\BrandingMode;
use NextPDF\Enterprise\Branding\BrandingStrategyFactory;

// The license resolves the mode; None is what a paid license produces.
$strategy = BrandingStrategyFactory::create(BrandingMode::None);

\var_dump($strategy->isActive());                 // bool(false)
echo $strategy->decorateProducer('NextPDF 3.1');  // NextPDF 3.1 (unchanged)

Kod örneği — Üretim

Zaten işlenmiş PDF baytlarını, lisansın çözümlediği stratejiyle işaretleyin. BrandingApplicator::apply(), ücretli bir lisans için girdiyi değiştirmeden döndürür ve bir değerlendirme lisansı için, orijinal baytları bozmadan filigranı ve meta veri işaretleyicilerini ekler. Etkin markalama güvenle uygulanamadığında BrandingApplicationException fırlatır — bunu nihai olarak değerlendirin ve işaretlenmemiş baytları asla teslim etmeyin.

apply-evaluation-branding.php

<?php

declare(strict_types=1);

use NextPDF\Enterprise\Branding\BrandingApplicationException;
use NextPDF\Enterprise\Branding\BrandingApplicator;
use NextPDF\Enterprise\Branding\BrandingMode;
use NextPDF\Enterprise\Branding\BrandingStrategyFactory;
use NextPDF\Enterprise\Branding\EvaluationBrandingConfig;

/**
 * Apply the branding the license resolved to freshly rendered PDF bytes.
 *
 * @param string       $renderedPdf Bytes from the render engine.
 * @param BrandingMode $mode        Resolved from the signed license envelope.
 *
 * @throws BrandingApplicationException When active branding cannot be marked.
 */
function markEvaluationOutput(string $renderedPdf, BrandingMode $mode): string
{
    $strategy = BrandingStrategyFactory::create(
        $mode,
        new EvaluationBrandingConfig(
            watermarkText: 'EVALUATION COPY — Not for Production Use',
        ),
    );

    try {
        return (new BrandingApplicator())->apply($renderedPdf, $strategy);
    } catch (BrandingApplicationException $e) {
        // Fail-closed: never emit unbranded evaluation output. Dead-letter.
        throw $e;
    }
}

Değerlendirme markalaması ne yapar

Etkin lisans EvaluationWatermark modunu seçtiğinde değerlendirme stratejisi:

• her sayfaya açık gri çapraz bir filigran metni çizer; bu, çevreleyen içeriği veya yerleşiminizi değiştirmemesi için yalıtılmış bir grafik durumunda bir sayfa içerik akışı olarak işlenir;
• belgenin üretici meta verisine bir değerlendirme son eki ekler;
• belgenin konu meta verisinin başına bir değerlendirme ön eki ekler.

Filigran, metni sayfa merkezi boyunca çapraz olarak konumlandırmak için bir Base14 yazı tipi ve bir döndürme matrisi kullanır. Yapılandırma nesnesi değişmezdir ve girdilerini doğrular (örneğin filigran metni boş olamaz ve yazı tipi boyutu pozitif olmalıdır).

Ücretli bir lisans markalamayı nasıl kaldırır

Ücretli (değerlendirme olmayan) bir lisans altında markalama modu None olur ve null stratejisi seçilir: filigran yok, üretici son eki yok, konu ön eki yok. Çıktı, hiçbir markalama alt sistemi olmadan üretilen çıktıyla aynıdır. Değerlendirme markalamasını kaldırmak hiçbir kod değişikliği gerektirmez — ücretli bir lisans kurun ve sonraki oluşturulan belge markasız olur.

Uç durumlar ve tuzaklar

• Markalama, lisans durumu değerlendirme tarzında olduğunda görünür. Bu bir kusuru değil, lisans durumunu yansıtır; lisans durumunu denetleyin ve lisans portalı aracılığıyla yenileyin.
• Filigran, değerlendirme çıktısının açık olması için tasarım gereği ortalanmış ve çaprazdır; üretim için ayarlanmak üzere tasarlanmamıştır. Ücretli bir lisans onu tamamen kaldırır.
• Üretici ve konu meta verisi, bir değerlendirme sırasında değerlendirme işaretleyicileri taşır ve ücretli bir lisans altında bulunmaz.

Performans

Filigran, oluşturma süresine veya belge boyutuna ihmal edilebilir etkisi olan, sayfa başına küçük, sabit bir içerik akışıdır. Ücretli bir lisans altında alt sistem hiçbir iş yapmaz. Sayfa performans bütçesi, belge işlemeyi yansıtır.

Güvenlik notları

Değerlendirme markalaması bir görünürlük işaretleyicisidir, bir güvenlik denetimi değildir. Değerlendirme çıktısını gösterir. Bir dijital imza değildir ve bir imza olarak ona güvenilmemelidir. Kurcalama-kanıtlı çıktı için özellik matrisinde açıklanan imzalama yeteneklerini kullanın. Markalama modunu seçen lisans, çalışma zamanının ihraççı imzasını doğruladığı imzalı bir zarftır.

Veri yerleşimi ve PII azaltmaları

Markalama alt sistemi, sabit bir filigran ve meta veri işaretleyicileri ekler; belge içeriğini okumaz veya iletmez ve hiçbir ağ çağrısı yapmaz.

Güvenli telemetri ve günlük temizleme

Alt sistem belge içeriğini günlüğe kaydetmez. Markalama modunu değiştiren lisans durumu geçişleri, burada değil, lisanslama alt sistemi aracılığıyla açığa çıkarılır.

Uygunluk

Bu sayfa için hiçbir standart uygunluğu iddia edilmez. Yalnızca çalışma zamanı davranışını açıklar. Herhangi bir garanti, sertifikasyon veya uygunluk beyan etmez ya da ima etmez. Değerlendirmenizin veya aboneliğinizin koşulları, yalnızca lisans sözleşmenizle tanımlanır.

FIPS modu davranışı

Bu modül hiçbir kriptografik işlem gerçekleştirmez. Lisans imzası doğrulaması, lisanslama alt sistemi tarafından işlenir.

Tehdit modeli

Markalama alt sisteminin kendisi, çözümlenen markalama modunun ötesinde hiçbir harici girdi işlemez. Modu seçen lisans zarfı imzalıdır ve ihraççı imzası çalışma zamanı tarafından doğrulanır; modu taklit etmek, o imzayı sahteleştirmeyi gerektirir.

Davranış sözleşmesi

• BrandingMode iki duruma sahiptir: None (varsayılan; çıktıda değişiklik yok) ve EvaluationWatermark.
• Ücretli (değerlendirme olmayan) bir lisans altında mod None olur ve null stratejisi seçilir: çıktı, hiçbir markalama alt sistemi olmadan üretilen çıktıyla aynıdır.
• Bir değerlendirme lisansı altında strateji, yalıtılmış bir grafik durumunda çapraz bir filigran çizer ve üretici ile konu meta verisine değerlendirme işaretleyicileri ekler.
• Yapılandırma nesnesi değişmezdir ve girdilerini doğrular (filigran metni boş değil, yazı tipi boyutu pozitif).

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

Markalama alt sistemi, nextpdf/enterprise paketinde sunulur; ancak bir değerlendirme lisansı kullanan yalnızca Core’lu ve yalnızca Pro’lu dağıtımlar dâhil tüm sürümler genelinde değerlendirme davranışını yönetir. Geri dönülecek yalnızca Core’a özgü bir markalama alt sistemi yoktur; herhangi bir sürümdeki ücretli bir lisans BrandingMode::None değerine çözümlenir.

Pro yedeği

Ayrı bir Pro markalama alt sistemi yoktur. Aynı nextpdf/enterprise markalama alt sistemi, Pro dağıtımları için değerlendirme davranışını yönetir; ücretli bir Pro lisansı, tıpkı ücretli bir Enterprise lisansı gibi BrandingMode::None değerine çözümlenir.

Enterprise sınır notu

Dahilî mekanizma ayrıntısı, kaynak deposunun dahilî belgelerinde kalır ve bu kılavuzun kapsamı dışındadır.

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

Markalama modunu seçen lisans zarfı, çalışma zamanının ihraççı imzasını doğruladığı imzalı bir yapıttır; lisans sağlama, yenileme ve lisansın güvenli saklanması operatörün sorumluluğundadır. Alt sistem hiçbir ağ çağrısı yapmaz ve hiçbir belge içeriği okumaz.

Hukuki uyumluluk sınırı

Bu sayfa yalnızca çalışma zamanı davranışını açıklar. Herhangi bir garanti, sertifikasyon veya uygunluk beyan etmez ya da ima etmez ve hukuki tavsiye oluşturmaz. Değerlendirmenizin veya aboneliğinizin koşulları — hangi markalamanın ve ne kadar süreyle geçerli olacağı dâhil — yalnızca lisans sözleşmenizle tanımlanır. O sözleşmeye başvurun veya satış ekibiyle iletişime geçin.

Ayrıca bakınız

• Markalama — Derinlemesine Referans — bu alt sistem için genel API ve davranış sözleşmesi.
• Deneme ve Değerlendirme Markalaması — uçtan uca değerlendirme öyküsü.
• Lisans etkinleştirme
• Enterprise genel bakışı
• Core, Pro ve Enterprise özellik matrisi