# 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 uma matriz associativa usando a propriedade pública `properties` dos objetos `Zend_Pdf`:

    $pdf = Zend_Pdf::load($pdfPath);

    echo $pdf->properties['Title'] . "\n";
    echo $pdf->properties['Author'] . "\n";

    $pdf->properties['Title'] = 'Novo Título.';
    $pdf->save($pdfPath);

As seguintes chaves são definidas pelo padrão PDF v1.4 (Acrobat 5):

- Title - string, opcional, o título do documento.

- Author - string, opcional, o nome da pessoa que criou o documento.

- Subject - string, opcional, o assunto do documento.

- Keywords - string, opcional, palavras-chave associadas ao documento.

- Creator - string, opcional, se o documento foi convertido para PDF a partir de outro formato, o nome da aplicação (por exemplo, Adobe FrameMaker®) que criou o documento original.

- Producer - string, opcional, se o documento foi convertido para PDF a partir de outro formato, o nome da aplicação (por exemplo, Acrobat Distiller) que o converteu para PDF.

- CreationDate - string, 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 por um dos 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 prefixo 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, e a letra Z indica que a hora é igual à Hora Universal. Se nenhuma informação sobre à Hora Universal 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 na hora local.

  Por exemplo, 23 de Dezembro de 1998, 7:52 da noite, U.S. Pacific Standard Time, é representado pela string "D:199812231952−08'00'".

- ModDate - string, opcional, a data e a hora da atualização mais recente no documento, na mesma forma de CreationDate.

- Trapped - booleano, 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 1.6 do PDF, os metadados podem ser armazenados em um documento XML especial anexado ao 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)`:

    $pdf = Zend_Pdf::load($pdfPath);
    $metadata = $pdf->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 = 'Novo título';
    $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.