المشترَك

لمحة سريعة

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

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

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

تُثبَّت حزمة ⁨Enterprise⁩ إلى جانب حزمة ⁨Core⁩؛ وتُستهلَك هذه الأوّليّات المشترَكة داخليًّا من وحدات ⁨Enterprise⁩ الأخرى وتُحَلّ مع الحزمة. ولا مكافئ لها في درجة ⁨Core⁩ أو درجة ⁨Pro⁩.

التثبيت

composer require nextpdf/enterprise:^3

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

‏BoundingBox كائن قيمة غير قابل للتغيير، إحداثياته الأربعة — ⁨x⁩ و⁨y⁩ والعرض والارتفاع — مُسوّاة إلى المجال [0.0, 1.0] نسبةً إلى أبعاد الصفحة. ولأن الإحداثيات مُسوّاة، يكون المربّع مستقلًّا عن الدقّة ويمكن إعادة استخدامه عبر وحدات ⁨Enterprise⁩ التي تستدلّ على هندسة الصفحة. ويتحقق المُنشئ من أن كل إحداثي ضمن المجال وأن x + width وy + height لا يتجاوزان ⁨1.0⁩ (ضمن تسامح فاصلة عائمة صغير)، رافعًا خطأ وسيطة خلاف ذلك.

ويعرض area() وcontains(self $other) وoverlaps(self $other). والمربّعات الصفرية المساحة (نقاط أو خطوط مُتدهوِرة) لا يمكن أن تتداخل بحكم التعريف.

ما الذي تؤكّده هذه الوحدة

تتولّى هذه الوحدة توفير أوّليّات هندسية مُتحقَّق منها. وهي لا تقدّم أي ادّعاء امتثال أو مطابقة ولا تؤدّي أي دخل/خرج.

حدّ الدرجة

‏«المشترَك» سطح دعم يقتصر على ⁨Enterprise⁩ تستهلكه وحدات ⁨Enterprise⁩ الأخرى. وهو لا يكرّر هندسة ⁨Core⁩ ولا يحلّ محلّها؛ إذ يوفّر الأوّليّات الصغيرة المُتحقَّق منها التي تتشاركها وحدات ⁨Enterprise⁩.

لماذا يعمل بهذه الطريقة

القرار الحامل هو تسوية كل إحداثي إلى المجال [0.0, 1.0] والتحقق منه في المُنشئ. فالإحداثيات المُسوّاة تجعل المربّع مستقلًّا عن الدقّة، فتبقى المنطقة المُوصوفة مرّة واحدة صحيحة عند أي حجم صفحة أو مقياس تصيير. والإنشاء المُغلَق عند الفشل يعني أن مربّعًا غير صالح أو فائضًا لا يمكن أن يوجد: إذ يرفضه المُنشئ بدلًا من قصّه أو تخمينه. ولذلك لا تُعيد وحدات ⁨Enterprise⁩ المُستهلِكة أبدًا فحص الهندسة التي تتلقّاها، لأن المربّع المُنشأ معروف الصحّة سلفًا. وتحفظ عدم القابلية للتغيير مربّعًا مشترَكًا آمنًا لتمريره بين الوحدات دون نسخ دفاعية. خلفية التصميم: ‏واجهة برمجة ترفض التخمين.

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

الصنف	المسؤولية
BoundingBox	مربّع مُسوّى غير قابل للتغيير؛ area() وcontains() وoverlaps().

نموذج شيفرة — بداية سريعة

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

نموذج شيفرة — الإنتاج

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

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

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

• يرفع الإنشاء بأي إحداثي خارج [0.0, 1.0]، أو بـ x + width / y + height فوق ⁨1.0⁩، خطأ وسيطة — تحقّق من المدخلات في المنبع.
• المربّعات الصفرية المساحة لا تتداخل أبدًا؛ احسب ذلك عند حساب التقاطعات.
• الإحداثيات مُسوّاة، لا بكسلات؛ حوّل عند حدّ التصيير.

الأداء

كل العمليات حساب ثابت الزمن على أربعة أرقام عائمة.

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

‏BoundingBox لا يؤدّي أي دخل/خرج ولا يحمل محتوى مستند. ويرفض المُنشئ الهندسة خارج المجال، فيمنع انتشار قيم مُتدهوِرة إلى الوحدات المُستهلِكة.

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

لا تحمل هذه الوحدة بيانات شخصية ولا تؤدّي أي احتفاظ أو دخل/خرج شبكي. ولا تنطبق اعتبارات الإقامة.

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

إحداثيات المربّع ومساحاته هندسة غير حسّاسة وآمنة للتسجيل.

المطابقة

لا تنفّذ هذه الوحدة أي معيار معياري ولا تقدّم أي ادّعاء مطابقة. وهي أوّليّة هندسية.

سلوك وضع ⁨FIPS⁩

لا تجري هذه الوحدة أي عملية تشفير؛ ولا ينطبق وضع ⁨FIPS⁩.

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

المُدخَل الوحيد أربعة أرقام عائمة. والتحقق من المجال والحدود في المُنشئ هو التخفيف: لا يمكن إنشاء هندسة غير صالحة.

عقد السلوك

• BoundingBox كائن قيمة غير قابل للتغيير، إحداثياته الأربعة مُسوّاة إلى المجال [0.0, 1.0] نسبةً إلى أبعاد الصفحة، فيكون مستقلًّا عن الدقّة.
• يتحقق المُنشئ من أن كل إحداثي ضمن المجال وأن x + width وy + height لا يتجاوزان ⁨1.0⁩ (ضمن تسامح فاصلة عائمة صغير)، رافعًا خطأ وسيطة خلاف ذلك.
• يعرض area() وcontains() وoverlaps()؛ والمربّعات الصفرية المساحة لا تتداخل أبدًا بحكم التعريف.
• لا تؤدّي الوحدة أي دخل/خرج، ولا تحمل محتوى مستند، ولا تقدّم أي ادّعاء امتثال أو مطابقة.

حدّ النشر

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

احتياطي ⁨Core⁩

احتياطي ⁨Core⁩ — لا شيء؛ هذه أوّليّة دعم مشترَكة تقتصر على ⁨Enterprise⁩. وهي لا تكرّر هندسة ⁨Core⁩ ولا تحلّ محلّها ولا مكافئ لها في درجة ⁨Core⁩.

احتياطي ⁨Pro⁩

احتياطي ⁨Pro⁩ — لا شيء؛ لهذه القدرة لا مكافئ في درجة ⁨Pro⁩. وتُشحَن أوّليّة BoundingBox المشترَكة في حزمة nextpdf/enterprise فقط.

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

تُوصَف الأوّليّة الهندسية المُتحقَّق منها على مستوى السلوك. وهي سطح دعم يقتصر على ⁨Enterprise⁩ تستهلكه وحدات ⁨Enterprise⁩ الأخرى؛ ولا توجد آليات فرعية داخلية تتجاوز العقد المُوثَّق.

حدّ النشر التشغيلي

حدّ النشر التشغيلي — لا شيء ينطبق؛ لا تؤدّي هذه الوحدة أي احتفاظ أو دخل/خرج شبكي، ولا تحمل محتوى مستند أو بيانات شخصية. ولا يوجد مورد يملكه المُشغِّل لهذا السطح.

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

لا ينطبق أي قيد لضوابط التصدير على هذا السطح. ولا تنفّذ الوحدة أي معيار معياري ولا تقدّم أي ادّعاء مطابقة أو اعتماد أو تنظيم. وهذه الوثيقة ليست رأيًا قانونيًّا.

انظر أيضًا

• التحقق — يستهلك الأوّليّات المشترَكة.
• الأدلّة — يستهلك الأوّليّات المشترَكة.
• المشترَك — المرجع العميق — مرجع عميق للأوّليّات المشترَكة.