العلامة التجارية

لمحة سريعة

يطبّق نظام العلامة التجارية الفرعي علامة تقييم ظاهرة على ملفات ⁨PDF⁩ المُولَّدة أثناء التقييم، ولا يطبّق شيئًا ضمن ترخيص مدفوع. وهو يُسلَّم في حزمة nextpdf/enterprise، ويحكم سلوك التقييم عبر الإصدارات، ومدفوعٌ بالترخيص بالكامل — لا بشيفرة التطبيق. وللاطّلاع على قصّة التقييم من الطرف إلى الطرف، راجِع التجربة وعلامة التقييم؛ وتوثّق هذه الصفحة نظام العلامة التجارية الفرعي نفسه.

التوفّر والترخيص

تُشحَن هذه القدرة في ⁨NextPDF Enterprise⁩ (nextpdf/enterprise) وتُفعَّل بمظروف ترخيص من فئة ⁨Enterprise⁩. ولا يحمّل النشرُ الذي يفتقر إلى ذلك الاستحقاق أصنافَ القدرة. ‏قارِن الإصدارات واحصل على ترخيص.

وخلافًا لأكثر أسطح ⁨Enterprise⁩، تحمل هذه القدرة رمز قدرة مخصّصًا، enterprise.branding، لأنها تحكم سلوك التقييم عبر كل الإصدارات — بما في ذلك عمليات النشر التي تقتصر على ⁨Core⁩ وتلك التي تقتصر على ⁨Pro⁩. ويُحَلّ وضع العلامة التجارية من مظروف الترخيص الموقَّع في وقت التشغيل؛ ولا تختاره أي راية تطبيق، ويَحلّ ترخيص مدفوع في أي إصدار إلى BrandingMode::None.

التثبيت

composer require nextpdf/enterprise:^3

نظرة مفاهيمية

لوقت التشغيل وضع علامة تجارية بحالتين، يُمثَّل بـ BrandingMode:

• ⁨None⁩ — لا علامة تقييم. ولا يُعدَّل المخرَج المدفوع أو العادي أبدًا. وهذا هو الوضع الافتراضي.
• ⁨EvaluationWatermark⁩ — تُطبَّق علامة تقييم ظاهرة على ملفات ⁨PDF⁩ المُولَّدة.

يربط BrandingStrategyFactory الوضع باستراتيجية: NullBrandingStrategy لـ ⁨None⁩ (لا تؤدّي عملًا ولا تُنتج تعديلًا) وEvaluationBrandingStrategy لـ ⁨EvaluationWatermark⁩. وتختار حالة الترخيص — لا شيفرة التطبيق — الوضع. ولا يُنتج الترخيص المدفوع مخرَجًا موسومًا أبدًا، ولا يوجد بناء إنتاجي يُبدَّل ولا راية شيفرة تُقلَب.

تصف هذه الصفحة سلوك وقت التشغيل فقط. وهي لا تقدّم أي ضمان ولا أي بيان عن الأهلية أو الأثر القانوني؛ فالشروط المنطبقة على تقييمك أو اشتراكك تُعرَّف حصرًا باتفاقية ترخيصك.

سطح واجهة البرمجة

المفهوم	السلوك
BrandingMode	حالتان: None (افتراضي، دون تعديل) أو EvaluationWatermark.
BrandingStrategyFactory	يَحلّ BrandingMode إلى استراتيجية.
EvaluationBrandingStrategy	يطبّق علامة التقييم المائية وتزيين البيانات الوصفية.
NullBrandingStrategy	استراتيجية لا تؤدّي عملًا للمخرَج المدفوع / العادي.
EvaluationBrandingConfig	نص علامة مائية وتزيين بيانات وصفية وحجم خط ومستوى رمادي وزاوية، غير قابلة للتغيير.
BrandingStrategy	العقد الذي تستهلكه طبقة التكامل: isActive()، buildPageWatermark()، decorateProducer()، decorateSubject().
BrandingApplicator	يطبّق استراتيجية محلولة على بايتات ⁨PDF⁩ المُصيَّرة؛ يفشل مغلقًا — يرمي BrandingApplicationException عندما يتعذّر وسم العلامة التجارية الفعّالة.

يكشف النظام الفرعي سطحًا قابلًا للاستدعاء صغيرًا لطبقة التكامل التي تطبّق الاستراتيجية التي حلّها الترخيص؛ ولا تختار شيفرة التطبيق أبدًا ما إذا كان يجب الوسم. وتبيّن العيّنتان أدناه نقطتَي التماس: قراءة استراتيجية محلولة، ووسم البايتات المُصيَّرة بالمُطبِّق الذي يفشل مغلقًا.

عيّنة شيفرة — البداية السريعة

احلُل الاستراتيجية التي اختارها الترخيص واقرأ سلوكها. ويَحلّ ترخيص مدفوع إلى BrandingMode::None، الذي تكون استراتيجيته غير فعّالة وتمرّر كل قيمة دون تغيير.

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)

عيّنة شيفرة — الإنتاج

سِم بايتات ⁨PDF⁩ المُصيَّرة سلفًا بالاستراتيجية التي حلّها الترخيص. ويُعيد BrandingApplicator::apply() المُدخَل دون تغيير لترخيص مدفوع، ويُلحِق — لترخيص تقييمي — العلامة المائية وعلامات البيانات الوصفية مع إبقاء البايتات الأصلية سليمة. ويرمي BrandingApplicationException عندما يتعذّر تطبيق العلامة التجارية الفعّالة بأمان — عامِل ذلك بوصفه نهائيًّا ولا تودِع البايتات غير الموسومة أبدًا.

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;
    }
}

ما الذي تفعله علامة التقييم

عندما يختار الترخيص الفعّال EvaluationWatermark، فإن استراتيجية التقييم:

• ترسم نص علامة مائية قُطريًّا بلون رمادي فاتح على كل صفحة، مُصيَّرًا بوصفه تدفّق محتوى صفحة في حالة رسومية معزولة بحيث لا يغيّر المحتوى المحيط ولا تخطيطك؛
• تُلحِق لاحقة تقييم ببيانات «المُنتِج» الوصفية للمستند؛
• تُقدِّم بادئة تقييم على بيانات «الموضوع» الوصفية للمستند.

تستخدم العلامة المائية خط ⁨Base14⁩ ومصفوفة تدوير لوضع النص قُطريًّا عبر مركز الصفحة. وكائن الإعداد غير قابل للتغيير ويتحقق من مدخلاته (مثلًا لا يمكن أن يكون نص العلامة المائية فارغًا ويجب أن يكون حجم الخط موجبًا).

كيف يزيل الترخيص المدفوع العلامة التجارية

ضمن ترخيص مدفوع (غير تقييمي) يكون وضع العلامة التجارية None وتُختار الاستراتيجية الفارغة: لا علامة مائية، ولا لاحقة مُنتِج، ولا بادئة موضوع. والمخرَج مطابق للمخرَج المُنتَج دون أي نظام علامة تجارية فرعي على الإطلاق. ولا تتطلّب إزالة علامة التقييم أي تغيير في الشيفرة — ثبّت ترخيصًا مدفوعًا فيكون المستند المُولَّد التالي بلا علامة.

الحالات الحدّية والمزالق

• تظهر العلامة التجارية عندما تكون حالة الترخيص بنمط تقييمي. ويعكس ذلك حالة الترخيص، لا عيبًا؛ افحص حالة الترخيص وجدّده عبر بوّابة التراخيص.
• العلامة المائية موسّطة وقُطرية عمدًا حتى يكون مخرَج التقييم لا لبس فيه؛ وهي ليست مُعدّة لِيُضبَط من أجل الإنتاج. ويزيلها ترخيص مدفوع كليًّا.
• تحمل بيانات «المُنتِج» و«الموضوع» الوصفية علامات تقييم أثناء التقييم وتغيب ضمن ترخيص مدفوع.

الأداء

العلامة المائية تدفّق محتوى صغير وثابت لكل صفحة بأثر زهيد على زمن التوليد أو حجم المستند. وضمن ترخيص مدفوع لا يؤدّي النظام الفرعي أي عمل. وتعكس ميزانية أداء الصفحة تصيير الوثائق.

ملاحظات أمنية

علامة التقييم وسم رؤية، لا ضابط أمان. فهي تشير إلى مخرَج تقييم. وهي ليست توقيعًا رقميًّا ويجب ألّا يُعتمَد عليها بوصفها كذلك. وللمخرَج الدالّ على العبث، استخدم قدرات التوقيع الموصوفة في مصفوفة الميزات. والترخيص الذي يختار وضع العلامة التجارية مظروف موقَّع يتحقق وقت التشغيل من توقيع مُصدِره.

إقامة البيانات وتخفيفات البيانات الشخصية

يضيف نظام العلامة التجارية الفرعي علامة مائية ثابتة وعلامات بيانات وصفية؛ وهو لا يقرأ محتوى المستند ولا ينقله ولا يُجري أي اتصال شبكي.

قياسات آمنة وتنقية السجلات

لا يسجّل النظام الفرعي محتوى المستند. وتُسطَّح انتقالات حالة الترخيص التي تغيّر وضع العلامة التجارية عبر نظام الترخيص الفرعي، لا هنا.

المطابقة

لا يُدَّعى أي مطابقة معايير لهذه الصفحة. فهي تصف سلوك وقت التشغيل فقط. وهي لا تذكر أو تُلمِّح إلى أي ضمان أو اعتماد أو أهلية. وتُعرَّف شروط تقييمك أو اشتراكك حصرًا باتفاقية ترخيصك.

سلوك وضع ⁨FIPS⁩

لا تجري هذه الوحدة أي عملية تشفير. ويتولّى التحقق من توقيع الترخيص نظام الترخيص الفرعي.

نموذج التهديد

لا يعالج نظام العلامة التجارية الفرعي نفسه أي مُدخَل خارجي يتجاوز وضع العلامة التجارية المُحَلّ. والمظروف الذي يختار الوضع موقَّع ويتحقق وقت التشغيل من توقيع مُصدِره؛ ويتطلّب انتحال الوضع تزويرَ ذلك التوقيع.

عقد السلوك

• لـ BrandingMode حالتان: None (افتراضي؛ دون تعديل المخرَج) وEvaluationWatermark.
• ضمن ترخيص مدفوع (غير تقييمي) يكون الوضع None وتُختار الاستراتيجية الفارغة: المخرَج مطابق للمخرَج المُنتَج دون أي نظام علامة تجارية فرعي على الإطلاق.
• ضمن ترخيص تقييمي ترسم الاستراتيجية علامة مائية قُطرية في حالة رسومية معزولة وتُلحِق علامات تقييم ببيانات «المُنتِج» و«الموضوع» الوصفية.
• كائن الإعداد غير قابل للتغيير ويتحقق من مدخلاته (نص العلامة المائية غير فارغ، وحجم الخط موجب).

حدّ النشر

توثّق هذه الصفحة السلوك القابل للرصد خارجيًّا وسطح واجهة البرمجة العام المدعوم فقط. ومسارات أسماء النطاقات الداخلية، والأصناف المساعِدة، وجداول الآليات، وأسماء ملفات أدلّة التشغيل، وبادئات التذاكر خارج النطاق.

احتياطي ⁨Core⁩

يُشحَن نظام العلامة التجارية الفرعي في حزمة nextpdf/enterprise لكنه يحكم سلوك التقييم عبر كل الإصدارات، بما فيها عمليات النشر التي تقتصر على ⁨Core⁩ و⁨Pro⁩ والتي تستخدم ترخيصًا تقييميًّا. ولا يوجد نظام علامة تجارية فرعي يقتصر على ⁨Core⁩ للارتداد إليه؛ ويَحلّ ترخيص مدفوع في أي إصدار إلى BrandingMode::None.

احتياطي ⁨Pro⁩

لا يوجد نظام علامة تجارية فرعي منفصل لـ ⁨Pro⁩. ويحكم نظام nextpdf/enterprise للعلامة التجارية نفسه سلوك التقييم لعمليات نشر ⁨Pro⁩؛ ويَحلّ ترخيص ⁨Pro⁩ مدفوع إلى BrandingMode::None تمامًا كما يفعل ترخيص ⁨Enterprise⁩ مدفوع.

ملاحظة حدّ ⁨Enterprise⁩

تبقى تفاصيل الآلية الداخلية في التوثيق الداخلي لمستودع المصدر وهي خارج نطاق هذا الدليل.

حدّ التوزيع

المظروف الذي يختار وضع العلامة التجارية أثرٌ موقَّع يتحقق وقت التشغيل من توقيع مُصدِره؛ وتوفير الترخيص وتجديده والتخزين الآمن له مسؤولية المُشغِّل. ولا يُجري النظام الفرعي أي اتصال شبكي ولا يقرأ محتوى مستند.

حدّ الامتثال القانوني

تصف هذه الصفحة سلوك وقت التشغيل فقط. وهي لا تذكر أو تُلمِّح إلى أي ضمان أو اعتماد أو أهلية، ولا تشكّل مشورة قانونية. وتُعرَّف شروط تقييمك أو اشتراكك — بما في ذلك ما العلامة التجارية المنطبقة ولأي مدّة — حصرًا باتفاقية ترخيصك. راجِع تلك الاتفاقية أو تواصَل مع المبيعات.

انظر أيضًا

• العلامة التجارية — المرجع العميق — واجهة البرمجة العامة وعقد السلوك لهذا النظام الفرعي.
• التجربة وعلامة التقييم — قصّة التقييم من الطرف إلى الطرف.
• تفعيل الترخيص
• نظرة عامة على ⁨Enterprise⁩
• مصفوفة ميزات ⁨Core⁩ مقابل ⁨Pro⁩ مقابل ⁨Enterprise⁩