الصفحة الرئيسة للتوافق: ما ينتجه NextPDF ومن يقرّر توافقه

لمحة سريعة

بيان الحدود. دعم ملمح ما ليس توافقًا؛ إذ يتولّى مدقّق مستقل تحديد التوافق.

تفهرس هذه الصفحة الملامح القياسية التي يستهدفها ⁨NextPDF Core.⁩ وتتبع كل صفحة في هذا القسم قاعدة معيارية واحدة: تنتج المكتبة مُخرجات يُقصد بها التوافق مع ملمح ما، ويقرّر مدقّق مستقل ما إذا كان ملف ⁨Portable Document Format⁩ (⁨PDF⁩) محدّد متوافقًا فعليًا. وقد يكون ذلك المدقّق ⁨veraPDF⁩، أو مدقّق ⁨PDF/UA⁩، أو مدقّق فواتير إلكترونية بصيغة ⁨Schematron⁩، أو الجهة المتلقّية. وبالنسبة إلى ⁨PDF/A⁩، يجعل ⁨ISO 19005-4⁩ §6.7.3 هذا الحدّ صريحًا: علامتا pdfaid:part/pdfaid:rev تحدّدان قصد المنتِج؛ وهما لا تقرّران التوافق. وتُحسم النتيجة بموجب بند التوافق في المعيار، عبر عملية خارج المكتبة المنتِجة.

لا يؤكّد ⁨NextPDF⁩ التوافق؛ بل يُصدر العناصر البنيوية التي يتطلّبها الملمح. وعندما يكون ملمح ما مقيّدًا، يُخفق ⁨NextPDF⁩ بسرعة عند حدود ⁨API⁩، فتظهر القدرة غير المتاحة في صورة خطأ واضح، لا في صورة ملف غير متوافق بصمت.

التثبيت

composer require nextpdf/core:^3

تتطلّب بعض الملامح الواردة أدناه حزمة nextpdf/pro الخاصة بـ ⁨Premium⁩؛ وتنبّه كل صفحة معنيّة إلى هذا الاشتراط. يوفّر ⁨Core⁩ مُميِّز التوافق (NextPDF\Conformance\ConformanceMode) ومدقّقات دفق البايتات في NextPDF\Compliance. ويأتي مسار تأليف ⁨OutputIntent⁩ / ⁨International Color Consortium⁩ (⁨ICC⁩) / ⁨Extensible Metadata Platform⁩ (⁨XMP⁩) الخاص بالملامح الأرشيفية ضمن nextpdf/pro.

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

يوجّه ⁨NextPDF⁩ المستند إلى عقد توافق عبر مُميِّز مُنمَّط وحيد، هو NextPDF\Conformance\ConformanceMode. ويُعدّ هذا التعداد المرجع الحاسم لعقد ⁨ISO⁩ الذي يجب على الكاتب الالتزام به. ويتضمن حالات لِـ Plain وPdfUa1 وPdfUa2 وPdfA2 وPdfA3/PdfA3b/PdfA3u، وPdfA4/PdfA4e/PdfA4f. يقرأ الكاتب الوضع ويُصدر البنية المطلوبة؛ ولا يعيّن أبدًا علامة تفيد بأن الملف متوافق.

تنطبق ثلاثة حدود على كل صفحة في هذا القسم:

الدعم ≠ التوافق. إصدار البيانات الوصفية التي يتطلّبها ملمح ما قدرة، لا حُكم.
التدقيق ≠ الاعتماد. تقرير مدقّق خالٍ من الأخطاء دليل، لا شهادة.
الملمح المُختبَر ≠ الاعتماد. تؤكّد اختبارات ⁨NextPDF⁩ أن البايتات المُصدَرة تطابق البنود المذكورة؛ لكنها ليست تدقيقًا معتمَدًا.

سطح الـ ⁨API⁩

نقاط الدخول المتعلّقة بالتوافق في NextPDF\Core\Document هي:

الطريقة	الأثر	الفئة
`enablePdfA(?object $version = null)`	يوجّه المستند إلى حالة `ConformanceMode` من نوع ⁨PDF/A⁩ (الافتراضي `PdfA4`)؛ ويجدول ⁨OutputIntent⁩ + ⁨ICC⁩ + ⁨XMP⁩ عند `save()`. يطرح `InvalidConfigException` إذا لم يكن `nextpdf/pro` موجودًا.	واجهة برمجة ⁨Core⁩، محرّك ⁨Premium⁩
`enableTaggedPdf(string $lang = 'en', ?ConformancePolicy $policy = null)`	يضبط `ConformanceMode::PdfUa2`، ويربط مُصدِر المحتوى الموسوم، ويتحقّق من وسم اللغة وفقًا للسياسة.	⁨Core⁩

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

<?php

declare(strict_types=1);

require_once __DIR__ . '/vendor/autoload.php';

use NextPDF\Core\Document;

$doc = Document::createStandalone();
$doc->enableTaggedPdf('en'); // ConformanceMode::PdfUa2
$doc->setTitle('Conformance index sample');
$doc->writeHtml('<h1>Hello</h1><p>Tagged content.</p>');
$doc->save(getenv('NEXTPDF_COOKBOOK_OUTPUT') ?: __DIR__ . '/out.pdf');

نموذج برمجي — بيئة الإنتاج

غير منطبق. توفّر صفحات كل ملمح على حدة نماذج إنتاجية قابلة للتشغيل؛ فهذا الفهرس صفحة توجيهية.

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

لا يؤكّد الفهرس أي سلوك. تحتوي صفحات كل ملمح على حدة على جداول الادّعاءات التي جرى التحقّق منها. تذكر هذه الصفحة القاعدة الحاكمة فقط.
اسم الملمح في البيانات الوصفية ادّعاء، لا دليل. عندما يجد القارئ pdfaid:part=4، فهو يرى قصد المنتِج، لا دليلًا على توافق الملف.
تقييد القدرات يخفق بسرعة. أي تثبيت يقتصر على ⁨Core⁩ ويستدعي مسارًا أرشيفيًا من ⁨Premium⁩ يحصل على InvalidConfigException مع رسالة ترقية، لا ملفًا غير متوافق بصمت أبدًا.

الأداء

غير منطبق على الفهرس. تعلن صفحات كل ملمح على حدة ميزانياتها الخاصة.

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

تقيّد ملامح التوافق البنية، لا الوضع الأمني تجاه التهديدات. يحظر ⁨PDF/A-4⁩ التشفير؛ ويتطلّب ⁨PDF/UA-2⁩ بنية يسهل الوصول إليها. ولا يُعدّ أيٌّ منهما ضابطًا أمنيًا. راجع مركز الثقة للاطلاع على النموذج الأمني للمحرّك.

التوافق

الادّعاء	المواصفة	البند
تحدّد علامات `pdfaid` الخاصة بالمنتِج القصد؛ وتُحسم النتيجة وفق بند التوافق في المعيار عبر مدقّق أو عملية، لا عبر المكتبة.	⁨ISO 19005-4⁩	§6.7.3
تُقيَّم مطابقة ⁨PDF/UA-2⁩ وفق اشتراطات المطابقة في المعيار، ولا تؤكّدها البرمجية المنتِجة.	⁨ISO 14289-2⁩	§7.2.2
يجب أن يستوفي ملف ⁨PDF 2.0⁩ المتوافق اشتراطات بنية الملف والذيل المحدّدة؛ والمكتبة تُصدرها لكنها لا تحسم النتيجة.	⁨ISO 32000-2⁩	§7.5.5

الاستشهادات هي مؤشّرات معرّف البند + reference_id إلى متن التحقّق. ولا يُعاد إنتاج أي نص من نصوص المعايير.