Informação do Documento e Metadados.
Um documento PDF deve incluir informações gerais como o título do documento, autor, e datas de criação e modificação.
Historicamente essas informações são armazenadas com o uso de estruturas especiais. Esta estrutura está
disponível para leitura e escrita como um array associativo usando a propriedade pública properties
dos obejtos Zend_Pdf:
properties['Title'] . "\n";
echo $pdf->properties['Author'] . "\n";
$pdf->properties['Title'] = 'New Title.';
$pdf->save($pdfPath);
]]>
As seguintes chaves são definidas pelo padrão PDF v1.4 (Acrobat 5):
Title - texto, opcional, o título do documento.
Author - texto, opcional, o nome da pessoa que criou o documento.
Subject - texto, opcional, o assunto do documento.
Keywords - texto, opcional, palavras-chave associadas ao documento.
Creator - texto, opcional, se o documento foi convertido para o formato PDF a
partir de outro formato, o nome da aplicação (por exemplo, Adobe FrameMaker®) que criou o documento original.
Producer - texto, opcional, se o documento foi convertido para o formato PDF a
partir de outro formato, o nome da aplicação (por exemplo, Adobe Distiller®) que converteu o converteu.
CreationDate - texto, opcional, a data e a hora na qual o documento foi criado, na seguinte forma:
"D:YYYYMMDDHHmmSSOHH'mm'", onde:
YYYY é o ano.
MM é o mês.
DD é o dia (01–31).
HH é a hora (00–23).
mm é o minuto(00–59).
SS é o segundo (00–59).
O é a relação da hora local com a hora Universal(UT),
denotada pelos caracteres +, −, ou Z (veja abaixo).
HH seguido por ' é o valor absoluto da diferença da hora Universal
em horas (00–23).
mm seguido por ' é o valor absoluto da diferença da hora Universal
em minutos (00–59).
O apóstrofo (') depois do HH e do mm é parte da sintaxe. Todos os campos depois do ano
são opcionais . (O préfixo D:, embora também seja opcional, é fortemente recomendado.)
Os valores padrões para MM e DD são, para ambos, 01; todos os outros campos numéricos
têm valor padrão zero. Um sinal positivo(+) no valor de um campo significa que a hora local
é mais tarde que a hora Universal, e um sinal negativo(−) indica que é mais cedo. A letra Z
indica que a hora é igual a hora Universal. Se nenhuma informação for específicada, a relação
da hora com a hora Universal é considerada desconhecida. Sendo ou não conhecido o fuso
horário, o resto da data deve ser especificado em "local time".
Por exemplo, 23 de Dezembro de 1998, 7:52 da noite, U.S. Pacific Standard Time, é
representado pela string "D:199812231952−08'00'".
ModDate - texto, opcional, a data e a hora da atualização mais recente no
documento, na mesma forma de CreationDate.
Trapped - boolean, opcional, indica se o documento foi modificado para a
inclusão de informações "trapped".
true - The document has been fully trapped; no further trapping is needed.
false - The document has not yet been trapped; any desired trapping must still be done.
null - Either it is unknown whether the document has been
trapped or it has been partly but not yet fully trapped; some
additional trapping may still be needed.
Desde a versão de PDF v 1.6 os metadados podem ser armazenados no documento XML especial anexado
ao documento PDF
(XMP - Extensible Metadata Platform).
Este documento XML pode ser recuperado e anexado ao PDF com os métodos Zend_Pdf::getMetadata() e
Zend_Pdf::setMetadata($metadata):
getMetadata();
$metadataDOM = new DOMDocument();
$metadataDOM->loadXML($metadata);
$xpath = new DOMXPath($metadataDOM);
$pdfPreffixNamespaceURI = $xpath->query('/rdf:RDF/rdf:Description')->item(0)->lookupNamespaceURI('pdf');
$xpath->registerNamespace('pdf', $pdfPreffixNamespaceURI);
$titleNode = $xpath->query('/rdf:RDF/rdf:Description/pdf:Title')->item(0);
$title = $titleNode->nodeValue;
...
$titleNode->nodeValue = 'New title';
$pdf->setMetadata($metadataDOM->saveXML());
$pdf->save($pdfPath);
]]>
Propriedades comuns são duplicadas na estrutura Info e nos Metadados do documento (se presente).
Agora é responsabilidade da aplicação do usuário mantê-los sincronizados.