Archivo PDF/A-4

★ Pro — Commercial License Required

Las funciones de cumplimiento PDF/A-4 requieren el paquete Pro.

TCPDF-Next Pro implementa la conformidad PDF/A-4 (ISO 19005-4:2020), el estándar de archivo más reciente basado en PDF 2.0.

Clases de archivo

Clase	Propósito
PdfAManager	Habilita, valida y aplica el cumplimiento PDF/A-4
PdfAVersion	Enum: A4, A4f, A4e
XmpMetadata	Dublin Core, XMP Basic, identificación PDF/A
OutputIntent	Perfiles de color ICC sRGB y personalizados
IccProfile	sRGB.icc incluido y carga de perfiles personalizados

PdfAVersion

Nivel	Caso de uso	Archivos incrustados	3D / Rich Media
A4	Archivo estándar	No	No
A4f	Documentos con adjuntos	Sí	No
A4e	Documentos de ingeniería	Sí	Sí

Habilitar 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

PDF/A requiere al menos un output intent. Usa métodos factory integrados o carga perfiles ICC personalizados:

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

OutputIntent::srgb();       // visualización en pantalla (más común)
OutputIntent::fogra39();    // offset europeo estucado
OutputIntent::gracol2006(); // impresión comercial estadounidense

// Perfil ICC personalizado
$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

Los metadatos XMP se generan automáticamente cuando se habilita PDF/A. Agrega propiedades 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');

Reglas de validación

Regla	Requisito
Output intent	Al menos uno requerido
Incrustación de fuentes	Todas las fuentes deben estar incrustadas (sin base-14)
Cifrado	No permitido
JavaScript	No permitido
Espacio de color	Independiente del dispositivo o cubierto por output intent
Metadatos XMP	Deben estar presentes y ser consistentes

Modo de aplicación

Captura violaciones inmediatamente cuando ocurren:

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

Validación manual

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

Combinar PDF/A-4 con 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 pasos

• Firmas digitales PAdES -- Creación de firmas en todos los niveles PAdES.
• Long-Term Validation -- DSS, OCSP, CRL y timestamps de archivo.
• Resumen del paquete Pro -- Listado completo de módulos e información de licencia.