Pro الإصدار

الرمز الشريطي

لمحة سريعة

يضيف ⁨NextPDF Pro⁩ ترميزات رموز شريطية ثنائية الأبعاد متخصّصة وترميزات سلسلة الإمداد فوق الترميزات الخطّية وترميزات ⁨QR⁩ في الإصدار المفتوح المصدر. يُخرَج كل ترميز مباشرةً إلى سطح صفحة ⁨PDF⁩ كدفق محتوى حتمي.

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

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

التثبيت

composer require nextpdf/pro:^3

تسجّل مُرمِّزات ⁨Pro⁩ نفسها من خلال سجلّ مُرمِّزات الرموز الشريطية القياسي. ويمكن للتطبيقات التي تبني سجلّها الخاص إعادة تسجيل مُرمِّزات ⁨Pro⁩ صراحةً من خلال مزوّد الخدمة المنشور.

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

يغطّي الإصدار المفتوح المصدر الترميزات الخطّية وترميزات ⁨QR⁩ اليومية. يوسّع ⁨NextPDF Pro⁩ السجلّ نفسه بترميزات متخصّصة للبيع بالتجزئة، والخدمات اللوجستية، والبريد، والاستخدام الصناعي عالي الكثافة:

‏⁨Micro QR Code⁩ — متغيّر ⁨QR⁩ المُدمَج لمساحات الملصقات الصغيرة.
‏⁨DotCode⁩ — ترميز مصفوفة نقطية مُصمَّم للوسم الصناعي عالي السرعة.
‏⁨Han Xin Code⁩ — ترميز ثنائي الأبعاد بسعة نص ⁨CJK⁩ أصيلة كبيرة المجموعة، وفق ⁨ISO/IEC 20830⁩.
‏⁨JabCode⁩ — ترميز ثنائي الأبعاد متعدّد الألوان بتتالي رموز متعدّدة.
‏⁨rMQR⁩ — متغيّر ⁨Micro QR⁩ المستطيل للملصقات الضيّقة العريضة.
‏⁨GS1 DataBar⁩ — عائلة ترميز ⁨GS1⁩ للبيع بالتجزئة والكوبونات.
‏⁨GS1 Composite (CC-C)⁩ — قاعدة أحادية البُعد مرتبطة إضافةً إلى مكوّن امتداد ⁨PDF417⁩ ثنائي الأبعاد عالي الكثافة يحمل بيانات معرّف تطبيق ⁨GS1⁩. (ترميز مكوّن الامتداد ثنائي الأبعاد ⁨CC-A⁩ و⁨CC-B⁩ غير مدعوم في هذا الإصدار؛ راجع مصفوفة الدعم.)

يُنتج كل مُرمِّز كائن بيانات رمز شريطي يحوّله مُخرِج الصفحة إلى مُشغِّلات محتوى ⁨PDF⁩. الترميز حتمي: المُدخَل والخيارات نفسها تُنتج دائمًا نمط الوحدة نفسه، ما يُبقي المستندات الموقَّعة والمؤرشَفة قابلة للاستنساخ.

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

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

كل مُرمِّز في ⁨Pro⁩ دالّة نقية: الحمولة والخيارات نفسها تُنتج دائمًا مصفوفة الوحدة نفسها، دون حالة خفية أو عشوائية مبذورة. تلك الحتمية هي القرار الحامل. فهي تتيح للرمز الشريطي أن يمرّ ذهابًا وإيابًا عبر مستند موقَّع أو مؤرشَف دون الإخلال بدفق البايتات، فلا تُبطِل إعادةُ الإخراج توقيعًا أبدًا. كما تجعل المطابقة قابلة للتدقيق: تربط مصفوفة الدعم كل ترميز بأثر مرجعي مخزَّن، يُفحَص بتًّا ببتّ مقابل ملف ذهبي. وتوسيع ⁨Core⁩ ‏BarcodeEncoderRegistry بدلًا من تشعيبه يُبقي هذه الضمانات متطابقة عبر الإصدار المفتوح وإصدار ⁨Pro⁩.

خلفية التصميم: البايتات نفسها في كل مرّة: ملفات ⁨PDF⁩ قابلة للاستنساخ.

سطح الـ ⁨API⁩

composer require nextpdf/pro:^3

يتألّف سطح الرمز الشريطي العام في ⁨Pro⁩ من:

نقطة دخول ساكنة لمزوّد الخدمة تسجّل مُرمِّزات ⁨Pro⁩ ثنائية الأبعاد في سجلّ مُرمِّزات رموز شريطية (MicroQR، وDotCode، وHanXin، وJabCode، وRMQR، وGS1DataBar، ومفتاح مكوّن ⁨GS1 Composite CC-C⁩ ‏gs1-composite-cc-c). ترميز مكوّن الامتداد ثنائي الأبعاد ⁨GS1 Composite CC-A⁩ و⁨CC-B⁩ غير مدعوم في هذا الإصدار وغير مُسجَّل.
مُحلِّل معرّف تطبيق ⁨GS1⁩ يقبل سلاسل ⁨AI⁩ المقروءة و⁨GS1 Digital Link URIs⁩ معًا ويُنتج تسلسلات بايتات مُرمَّزة لحاملات ⁨GS1-128⁩ و⁨QR Code⁩ و⁨Data Matrix⁩.
مُتحقِّق سلسلة إمداد ⁨GS1⁩ يفحص أرقام التحقّق، وبنية ⁨AI⁩، ومنطق التواريخ، وتراكيب ⁨AI⁩ الإلزامية في ملف تعريف الصناعة.

يُخرَج جدول توقيع الطرائق المولَّد الكامل في المرجع المتعمّق للرمز الشريطي.

مثال برمجي — بداية سريعة

use NextPDF\Barcode\BarcodeEncoderRegistry;
use NextPDF\Pro\Barcode\BarcodeProServiceProvider;

$registry = new BarcodeEncoderRegistry();
BarcodeProServiceProvider::register($registry);
// $registry now resolves the Pro specialty symbologies.

مثال برمجي — إنتاج

use NextPDF\Pro\Barcode\Gs1\Gs1Validator;
use NextPDF\Pro\Barcode\Gs1\Gs1SupplyChainProfile;

$result = Gs1Validator::validate(
    '(01)09521234543213(17)260131(10)ABC123',
    Gs1SupplyChainProfile::NONE,
);

if (! $result->isValid) {
    // Surface findings to your observability pipeline before encoding.
    foreach ($result->findings as $finding) {
        $logger->warning('GS1 validation finding', [
            'rule' => $finding->ruleId,
            'detail' => $finding->message,
        ]);
    }
}

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

يربط السجلّ الافتراضي مدخلات مُرمِّز ⁨Pro⁩ مسبقًا بتكاسل ويُسوِّرها عبر سجلّ القدرات. استدعاء BarcodeProServiceProvider::register() صريح هو الاحتياط المدعوم عندما يؤلّف تطبيق سجلّه الخاص دون افتراضات.
إعادة التسجيل حياديّة التكرار: يستبدل استدعاء register() ثانٍ الربطَ الأول بدلًا من الإثارة.
تغطية متغيّرات ⁨GS1 DataBar⁩ جزئية بالتصميم. ⁨Omnidirectional⁩، و⁨Truncated⁩، و⁨Stacked⁩، و⁨Stacked Omnidirectional⁩، و⁨Limited⁩ متحقَّق منها مرجعيًا؛ أما ⁨Expanded⁩ و⁨Expanded Stacked⁩ فخارجان عن النطاق في هذا الإصدار. راجع مصفوفة الدعم.
يقبل ⁨rMQR⁩ كل إصدار ⁨ISO 23941⁩ عبر مجموعة المطابقة المُتحقَّق منها وفق المُلحَق. قد تُقلِّل البيانات الوصفية لتتبّع النطاق التي تسبق توسيع مدى الأحجام اللاحق من شأن هذا؛ وتسجّل مصفوفة الدعم الواقع المُتحقَّق منه في الشيفرة.

الأداء

تتناسب تكلفة الترميز مع طول الحمولة وحجم الرمز المستهدف. يُخطِّط كل ترميز رمزه في تمريرة واحدة دون إعادة تدفّق. تتناسب تتاليات ⁨JabCode⁩ متعدّدة الرموز مع عدد الرموز (1–61). يحتفظ الترميز بمصفوفة الوحدة في الذاكرة؛ ويحدّ أكبر إصدار رمز مختار التكلفة.

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

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

المطابقة

يتبع كل ترميز معياره المنشور ذا الصلة (⁨ISO/IEC 24724⁩ لـ ⁨GS1 DataBar⁩، و⁨ISO/IEC 24723⁩ لـ ⁨GS1 Composite⁩، و⁨ISO/IEC 23941⁩ لـ ⁨rMQR⁩، و⁨ISO/IEC 18004 Annex⁩ لـ ⁨Micro QR⁩، و⁨ISO/IEC 20830⁩ لـ ⁨Han Xin Code⁩، و⁨ISO/IEC 23634⁩ لـ ⁨JabCode⁩، و⁨USPS-B-3200⁩ للترميز البريدي). يُخرَج تعيين المطابقة على مستوى البنود مع معرّفات الاستشهاد في المرجع المتعمّق للرمز الشريطي.

حدود النشر

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