Uygunluğa giriş: NextPDF ne üretir ve uygunluğa kim karar verir

Bir bakışta

Sınır ifadesi. Bir profilin desteklenmesi uygunluk anlamına gelmez; uygunluk kararını bağımsız bir doğrulayıcı verir.

Bu sayfa, NextPDF Core uygulamasının hedeflediği standart profilleri listeler. Bu bölümdeki her sayfa, standartlardan gelen tek bir kurala dayanır: kitaplık, bir profile uygun olması amaçlanan çıktı üretir ve belirli bir Portable Document Format (PDF) dosyasının gerçekten uygun olup olmadığına bağımsız bir doğrulayıcı karar verir. Bu doğrulayıcı veraPDF, bir PDF/UA denetleyicisi, bir Schematron e-fatura doğrulayıcısı veya alıcı makam olabilir. PDF/A için ISO 19005-4 §6.7.3 bu sınırı açıkça belirtir: pdfaid:part/pdfaid:rev işaretleyicileri üreticinin niyetini belirtir; uygunluğa karar vermezler. Karar, standardın uygunluk maddesi kapsamında, üretimi yapan kitaplığın dışındaki bir süreç tarafından verilir.

NextPDF uygunluk iddiasında bulunmaz. Bir profilin gerektirdiği yapısal öğeleri üretir. Bir profil bir yeteneği kısıtladığında NextPDF, API sınırında hızla başarısız olur; böylece eksik bir yetenek, sessizce uyumsuz bir dosya olarak değil, açık bir hata olarak ortaya çıkar.

Kurulum

composer require nextpdf/core:^3

Aşağıdaki bazı profiller Premium nextpdf/pro paketini gerektirir; ilgili her sayfa bu gereksinimi belirtir. Core, uygunluk ayırıcısını (NextPDF\Conformance\ConformanceMode) ve NextPDF\Compliance içindeki bayt akışı doğrulayıcılarını içerir. Arşivleme profilleri için OutputIntent / International Color Consortium (ICC) / Extensible Metadata Platform (XMP) oluşturma yolu nextpdf/pro içinde yer alır.

Kavramsal genel bakış

NextPDF, bir belgeyi tek bir tür ayırıcısı olan NextPDF\Conformance\ConformanceMode aracılığıyla bir uygunluk sözleşmesine yönlendirir. Bu enum, yazıcının uyması gereken ISO sözleşmesi için tek doğruluk kaynağıdır. Şu durumlara sahiptir: Plain, PdfUa1, PdfUa2, PdfA2, PdfA3/PdfA3b/PdfA3u ve PdfA4/PdfA4e/PdfA4f. Yazıcı, modu okur ve gerekli yapıyı üretir; dosyanın uygun olduğunu belirten bir bayrağı asla ayarlamaz.

Bu bölümdeki her sayfada üç sınır geçerlidir:

Destek ≠ uygunluk. Bir profilin gerektirdiği meta verileri üretmek bir yetenektir, bir karar değildir.
Doğrulama ≠ sertifikalandırma. Hata içermeyen bir doğrulayıcı raporu bir kanıttır, bir sertifika değildir.
Test edilmiş bir profil ≠ sertifikalandırma. NextPDF’in testleri, üretilen baytların alıntılanan maddelerle eşleştiğini doğrular; bunlar akredite bir denetim değildir.

API yüzeyi

Uygunluk giriş noktaları, NextPDF\Core\Document üzerinde şunlardır:

Yöntem	Etki	Katman
`enablePdfA(?object $version = null)`	Belgeyi bir PDF/A `ConformanceMode` durumuna yönlendirir (varsayılan `PdfA4`); OutputIntent + ICC + XMP işlemlerini `save()` aşamasında çalışacak şekilde zamanlar. Şu istisnayı fırlatır: `InvalidConfigException` — `nextpdf/pro` yoksa.	Core API, Premium altyapı
`enableTaggedPdf(string $lang = 'en', ?ConformancePolicy $policy = null)`	Şu değeri ayarlar: `ConformanceMode::PdfUa2`, etiketli içerik üreticisini bağlar, dil etiketini ilkeye göre doğrular.	Core

Kod örneği — hızlı başlangıç

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

Kod örneği — üretim

Uygulanamaz. Her profile ait sayfalar çalıştırılabilir üretim örnekleri sağlar; bu dizin bir yönlendirme sayfasıdır.

Uç durumlar ve tuzaklar

Dizin hiçbir davranış iddiasında bulunmaz. Her profile ait sayfalar doğrulanmış iddia tablolarını içerir. Bu sayfa yalnızca geçerli kuralı belirtir.
Meta verideki bir profil adı bir iddiadır, bir kanıt değildir. pdfaid:part=4 bulan bir okuyucu, üreticinin niyetini görür; dosyanın uygun olduğuna dair bir kanıt görmez.
Yetenek kısıtlaması hızla başarısız olur. Yalnızca Core kurulumu, bir Premium arşivleme yolunu çağırdığında sessizce uyumsuz bir dosya üretmek yerine, yükseltme mesajı içeren InvalidConfigException alır.

Performans

Bu dizin için uygulanamaz. Her profile ait sayfalar kendi bütçelerini bildirir.

Güvenlik notları

Uygunluk profilleri tehdit duruşunu değil, yapıyı kısıtlar. PDF/A-4 şifrelemeyi yasaklar; PDF/UA-2 erişilebilir yapı gerektirir. Hiçbiri bir güvenlik denetimi değildir. Altyapının güvenlik modeli için güven merkezine başvurun.

Uygunluk

İddia	Spesifikasyon	Madde
Üreticinin `pdfaid` işaretleyicileri niyeti belirtir; standardın uygunluk maddesi, belirlemenin kitaplık tarafından değil, bir doğrulayıcı veya süreç tarafından yapılmasını esas alır.	ISO 19005-4	§6.7.3
PDF/UA-2 uygunluğu, standardın uygunluk gereksinimlerine göre değerlendirilir; üreten yazılım tarafından iddia edilmez.	ISO 14289-2	§7.2.2
Uygun bir PDF 2.0 dosyası, tanımlanmış dosya yapısı ve fragman gereksinimlerini karşılamalıdır; kitaplık bunları üretir ancak sonuca karar vermez.	ISO 32000-2	§7.5.5

Atıflar, doğrulama derlemesine yönelik madde kimliği + reference_id işaretçileridir. Hiçbir standart metni yeniden üretilmez.