repo_zf1/documentation/manual/fr/module_specs/Zend_Pdf-Create.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.pdf.create">
    <title>Créer et charger des documents PDF</title>

    <para>
        La classe <classname>Zend_Pdf</classname> représente le document <acronym>PDF</acronym> en lui-même et
        fournis des méthodes pour manipuler l'ensemble du document.
    </para>

    <para>
        Pour créer un nouveau document, un nouvel objet <classname>Zend_Pdf</classname> doit
        être créé.
    </para>

    <para>
        La classe <classname>Zend_Pdf</classname> fournis deux méthodes statiques pour charger
        un <acronym>PDF</acronym> existant. Ce sont les méthodes <methodname>Zend_Pdf::load()</methodname> et
        <methodname>Zend_Pdf::parse()</methodname>. Les deux retournent un objet
        <classname>Zend_Pdf</classname> ou lève une exception en cas d'erreur.
    </para>

    <example id="zend.pdf.create.example-1">
        <title>Créer un nouveau document PDF ou en charger un existant</title>

        <programlisting language="php"><![CDATA[
...
/// Crée un nouveau document PDF.
$pdf1 = new Zend_Pdf();

// Charge un document PDF depuis un fichier.
$pdf2 = Zend_Pdf::load($fileName);

// Charge un document PDF depuis une string
$pdf3 = Zend_Pdf::parse($pdfString);
...
]]></programlisting>
    </example>

    <para>
        Le format de fichier <acronym>PDF</acronym> supporte la mise à jour incrémentale d'un document. Ainsi
        chaque fois que le document est mis à jour, une nouvelle version du document est créée. Le
        module <classname>Zend_Pdf</classname> supporte la récupération d'une version
        spécifique.
    </para>

    <para>
        La version peut-être donnée en second paramètre des méthodes
        <methodname>Zend_Pdf::load()</methodname> et <methodname>Zend_Pdf::parse()</methodname> ou
        obligatoire dans le cas d'un appel à <methodname>Zend_Pdf::rollback()</methodname> <footnote>
            <para>
                La méthode <methodname>Zend_Pdf::rollback()</methodname> doit être appelée avant
                tout changement. Sinon le comportement est indéfini.
            </para>
            </footnote>
        </para>

    <example id="zend.pdf.create.example-2">
        <title>Demander une version particulière d'un document PDF</title>

        <programlisting language="php"><![CDATA[
...
// Charge la version précédente d'un document PDF.
$pdf1 = Zend_Pdf::load($fileName, 1);

// Charge la version précédente d'un document PDF.
$pdf2 = Zend_Pdf::parse($pdfString, 1);

// Charge la première version d'un document
$pdf3 = Zend_Pdf::load($fileName);
$revisions = $pdf3->revisions();
$pdf3->rollback($revisions - 1);
...
]]></programlisting>
    </example>
</sect1>