PDF/A-4 Archival

★ Pro — Commercial License Required

Os recursos de conformidade PDF/A-4 requerem o pacote Pro.

O TCPDF-Next Pro implementa a conformidade PDF/A-4 (ISO 19005-4:2020), o mais recente padrão de arquivamento baseado em PDF 2.0.

Classes de Archive

Classe	Finalidade
PdfAManager	Habilita, valida e aplica a conformidade PDF/A-4
PdfAVersion	Enum: A4, A4f, A4e
XmpMetadata	Dublin Core, XMP Basic, identificação PDF/A
OutputIntent	Perfis de cor ICC sRGB e personalizados
IccProfile	sRGB.icc incluído e carregamento de perfis personalizados

PdfAVersion

Nível	Caso de Uso	Arquivos Incorporados	3D / Rich Media
A4	Arquivamento padrão	Não	Não
A4f	Documentos com anexos	Sim	Não
A4e	Documentos de engenharia	Sim	Sim

Habilitando PDF/A-4

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 e IccProfile

O PDF/A requer pelo menos um output intent. Use os métodos de fábrica incluídos ou carregue perfis ICC personalizados:

use Yeeefang\TcpdfNext\Pro\Archive\{OutputIntent, IccProfile};

OutputIntent::srgb();       // screen display (most common)
OutputIntent::fogra39();    // European coated offset
OutputIntent::gracol2006(); // US commercial printing

// Custom ICC profile
$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

Os metadados XMP são gerados automaticamente quando o PDF/A é habilitado. Adicione propriedades personalizadas:

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

Regras de Validação

Regra	Requisito
Output intent	Pelo menos um obrigatório
Incorporação de fontes	Todas as fontes devem ser incorporadas (sem base-14)
Criptografia	Não permitida
JavaScript	Não permitido
Espaço de cor	Independente de dispositivo ou coberto pelo output intent
Metadados XMP	Devem estar presentes e consistentes

Modo de Imposição

Capture violações imediatamente conforme ocorrem:

$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."

Validação Manual

$result = $manager->validate();
foreach ($result->violations() as $v) {
    echo "{$v->severity()}: {$v->message()} [{$v->clause()}]\n";
}

Combinando PDF/A-4 com PAdES B-LTA

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

Próximos Passos

• Assinaturas Digitais PAdES -- Criação de assinaturas em todos os níveis PAdES.
• Long-Term Validation -- DSS, OCSP, CRL e timestamps de arquivamento.
• Visão Geral do Pacote Pro -- Listagem completa de módulos e informações de licença.