Arsip PDF/A-4
★ Pro — Commercial License Required
Fitur kepatuhan PDF/A-4 memerlukan paket Pro.
TCPDF-Next Pro mengimplementasikan kepatuhan PDF/A-4 (ISO 19005-4:2020), standar arsip terbaru berdasarkan PDF 2.0.
Class Archive
| Class | Tujuan |
|---|---|
PdfAManager | Mengaktifkan, memvalidasi, dan menegakkan kepatuhan PDF/A-4 |
PdfAVersion | Enum: A4, A4f, A4e |
XmpMetadata | Dublin Core, XMP Basic, identifikasi PDF/A |
OutputIntent | Profil warna sRGB dan ICC kustom |
IccProfile | sRGB.icc bawaan dan loading profil kustom |
PdfAVersion
| Level | Kasus Penggunaan | File yang Disematkan | 3D / Rich Media |
|---|---|---|---|
A4 | Arsip standar | Tidak | Tidak |
A4f | Dokumen dengan lampiran | Ya | Tidak |
A4e | Dokumen engineering | Ya | Ya |
Mengaktifkan PDF/A-4
php
use Yeeefang\TcpdfNext\Core\Document;
use Yeeefang\TcpdfNext\Pro\Archive\{PdfAManager, PdfAVersion, OutputIntent};
$pdf = Document::create()
->metadata(title: 'Annual Report 2026', author: 'Finance')
->addPage()
->font('NotoSans', size: 12)
->text('PDF/A-4 compliant document.');
PdfAManager::enable($pdf, PdfAVersion::A4)
->outputIntent(OutputIntent::srgb());
$pdf->save('/archive/report.pdf');OutputIntent dan IccProfile
PDF/A memerlukan setidaknya satu output intent. Gunakan factory method bawaan atau muat profil ICC kustom:
php
use Yeeefang\TcpdfNext\Pro\Archive\{OutputIntent, IccProfile};
OutputIntent::srgb(); // tampilan layar (paling umum)
OutputIntent::fogra39(); // European coated offset
OutputIntent::gracol2006(); // US commercial printing
// Profil ICC kustom
$custom = new OutputIntent(
subtype: 'GTS_PDFA1', outputConditionIdentifier: 'Custom_CMYK',
info: 'Internal press profile', registryName: 'https://printing.example.com/profiles',
iccProfile: IccProfile::load('/profiles/custom.icc')->bytes(),
);XmpMetadata
Metadata XMP dihasilkan otomatis saat PDF/A diaktifkan. Tambahkan property kustom:
php
$xmp = $pdf->xmpMetadata();
$xmp->set('dc:rights', 'Copyright 2026 Acme Corporation');
$xmp->registerNamespace('acme', 'https://acme.example.com/xmp/1.0/');
$xmp->set('acme:DocumentId', 'DOC-2026-0042');Aturan Validasi
| Aturan | Persyaratan |
|---|---|
| Output intent | Setidaknya satu diperlukan |
| Embedding font | Semua font harus di-embed (tidak ada base-14) |
| Enkripsi | Tidak diizinkan |
| JavaScript | Tidak diizinkan |
| Color space | Device-independent atau dicakup oleh output intent |
| Metadata XMP | Harus ada dan konsisten |
Mode Enforcement
Tangkap pelanggaran segera saat terjadi:
php
$manager = PdfAManager::enable($pdf, PdfAVersion::A4);
$manager->enforce(true);
$pdf->javascript(trigger: 'open', script: 'app.alert("Hello");');
// -> PdfAException: "PDF/A-4 violation: JavaScript actions are not permitted."Validasi Manual
php
$result = $manager->validate();
foreach ($result->violations() as $v) {
echo "{$v->severity()}: {$v->message()} [{$v->clause()}]\n";
}Menggabungkan PDF/A-4 dengan PAdES B-LTA
php
use Yeeefang\TcpdfNext\Pro\Security\Signature\{DigitalSigner, CertificateInfo};
use Yeeefang\TcpdfNext\Pro\Security\Timestamp\TsaClient;
use Yeeefang\TcpdfNext\Contracts\Enums\SignatureLevel;
PdfAManager::enable($pdf, PdfAVersion::A4)
->outputIntent(OutputIntent::srgb());
$signer = new DigitalSigner(
CertificateInfo::fromPkcs12('/certs/archive.p12', 'pw')
);
$signer->level(SignatureLevel::PAdES_B_LTA);
$signer->timestampAuthority(new TsaClient('https://tsa.example.com/timestamp'));
$signer->sign($pdf);
$pdf->save('/archive/signed-archival.pdf');Langkah Selanjutnya
- Tanda Tangan Digital PAdES -- Pembuatan tanda tangan di semua level PAdES.
- Long-Term Validation -- DSS, OCSP, CRL, dan archival timestamp.
- Ringkasan Paket Pro -- Daftar modul lengkap dan informasi lisensi.