1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
<?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>
|
