หน้าหลักด้านความสอดคล้อง: สิ่งที่ NextPDF สร้างและผู้ตัดสินความสอดคล้อง

ภาพรวมโดยย่อ

คำชี้แจงขอบเขต การรองรับโปรไฟล์ไม่ใช่ความสอดคล้อง ตัวตรวจสอบ (validator) ที่เป็นอิสระเป็นผู้ตัดสินความสอดคล้อง

หน้านี้จัดทำดัชนีโปรไฟล์มาตรฐานที่ NextPDF Core มุ่งสร้าง ทุกหน้าในส่วนนี้ยึดกฎเดียวกันจากมาตรฐาน: ไลบรารีสร้างเอาต์พุตที่ มุ่งให้สอดคล้อง กับโปรไฟล์ และตัวตรวจสอบที่เป็นอิสระเป็นผู้ตัดสินว่าไฟล์ Portable Document Format (PDF) ที่ระบุนั้นสอดคล้องจริงหรือไม่ ตัวตรวจสอบดังกล่าวอาจเป็น veraPDF ตัวตรวจสอบ PDF/UA ตัวตรวจสอบใบแจ้งหนี้อิเล็กทรอนิกส์แบบ Schematron หรือหน่วยงานผู้รับเอกสาร สำหรับ PDF/A นั้น ISO 19005-4 §6.7.3 ระบุขอบเขตนี้ไว้อย่างชัดเจน: เครื่องหมาย pdfaid:part/pdfaid:rev แสดงเจตนาของผู้สร้าง แต่ไม่ได้ตัดสินความสอดคล้อง การตัดสินทำตามข้อกำหนดความสอดคล้องของมาตรฐาน โดยใช้กระบวนการที่อยู่นอกไลบรารีผู้สร้าง

NextPDF ไม่ยืนยันความสอดคล้อง แต่สร้างองค์ประกอบเชิงโครงสร้างตามที่โปรไฟล์กำหนด เมื่อโปรไฟล์ถูกจำกัดสิทธิ์ (gated) NextPDF จะล้มเหลวทันทีที่ขอบเขตของ API เพื่อให้ความสามารถที่ขาดหายไปแสดงเป็นข้อผิดพลาดที่ชัดเจน ไม่ใช่ไฟล์ที่ไม่สอดคล้องอย่างเงียบ ๆ

การติดตั้ง

composer require nextpdf/core:^3

โปรไฟล์บางรายการด้านล่างต้องใช้แพ็กเกจ Premium nextpdf/pro โดยหน้าของแต่ละโปรไฟล์จะระบุข้อกำหนดดังกล่าวไว้ Core มาพร้อมตัวจำแนกความสอดคล้อง (NextPDF\Conformance\ConformanceMode) และตัวตรวจสอบสตรีมระดับไบต์ใน NextPDF\Compliance ส่วนเส้นทางการเขียน OutputIntent / International Color Consortium (ICC) / Extensible Metadata Platform (XMP) สำหรับโปรไฟล์เพื่อการจัดเก็บถาวรอยู่ในแพ็กเกจ nextpdf/pro

ภาพรวมเชิงแนวคิด

NextPDF นำเอกสารเข้าสู่สัญญาความสอดคล้องผ่านตัวจำแนกแบบมีชนิดเดียว คือ NextPDF\Conformance\ConformanceMode enum นี้เป็นแหล่งความจริงสำหรับสัญญา ISO ที่ตัวเขียน (writer) ต้องปฏิบัติตาม โดยมีกรณีสำหรับ 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 API, เอนจิน 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 ที่สอดคล้องต้องเป็นไปตามข้อกำหนดด้านโครงสร้างไฟล์และส่วนท้าย (trailer) ที่กำหนดไว้ ไลบรารีสร้างองค์ประกอบเหล่านี้ แต่ไม่ได้ตัดสินผลลัพธ์	ISO 32000-2	§7.5.5

การอ้างอิงใช้ตัวชี้แบบ clause-id + reference_id ไปยังคลังข้อมูลตรวจสอบ ไม่มีการคัดลอกข้อความของมาตรฐานมาแสดงซ้ำ