Manuál PHP | ||
---|---|---|
Předcházející | Další |
PDF funkce v PHP mohou vytvořit PDF soubory s využitím knihovny PDFlib vytvořené Thomasem Merzem.
Dokumentace této sekce je myšlena pouze jako přehled dostupných funkcí v knihovně PDFlib a neměla by být považována za vyčerpávající přehled. Prosím konzultujte dokumentaci obsaženou v distribuci PDFlib pro úplné a detailní vysvětlené každé zde uvedené funkce. Poskytuje velmi dobrý přehled toho, co PDFlib dokáže a obsahuje nejčerstvější dokumentaci ke všem funkcím.
Většina funkcí pdflib a příslušného PHP modulu má stejné jméno. Argumenty jsou také identické. Pokud chcete tento modul využívat opravdu efektivně, měli byste chápat také některé z konceptů PDF nebo Postscriptu. Všechny rozměry a koordináty se udávají v Postscriptových bodech. Obecně je 72 PostScriptových bodů na palec, ale závisí to na výstupním rozlišení. Věnujte prosím pozornost dokumentaci pdflib, která je součástí distribuce zdrojového kódu, pro bližší vysvětlení použitého souřadnicového systému.
Vemte prosím na vědomí, že většina PDF funkcí vyžaduje
pdfdoc
jako první parametr. Viz
příklady níže pro bližší
vysvětlení.
Poznámka: Pokud se zajímáté o alternativní volně dostupné PDF generátory, které nepotřebují externí PDF knihovny, podívejte se na tuto související FAQ.
PDFlib lze stáhnout na http://www.pdflib.com/products/pdflib-family/, ale vyžaduje, abyste zakoupili licenci pro komerční použití. Pro zkompilování tohoto rozšíření jsou potřeba knihovny JPEG a TIFF.
Žádná verze PHP 4 od data 9. března 2000 nepodporuje podflib starší než 3.0.
PDFlib 3.0 a vyšší je podporováno PHP 3.0.19 a vyšší.
Abyste mohli tyto funkce používat, musíte PHP zkompilovat s volbou
--with-pdflib[=DIR]
. DIR je základní
instalační adresář PDFlib, výchozí hodnota je /usr/local.
Navíc můžete určit knihovny jpeg, tiff a png, které má PDFlib
používat, což je volitelné v PDFlib 4.x.
Pokud tak chcete učinit, přidejte volby configure
--with-jpeg-dir[=DIR]
--with-png-dir[=DIR]
--with-tiff-dir[=DIR]
.
Od pdflib 3.0 by se pdflib měla konfigurovat s volbou --enable-shared-pdflib.
Toto rozšíření nemá definováno žádné konfigurační direktivy.
Od PHP 4.0.5 je PHP rozšíření oficiálně podporováno společností PDFlib GmbH. To znamená, že všechny funkce popsané v PDFlib manuálu (V3.00 nebo vyšší) jsou podporovány v PHP 4 s přesně stejným významem a stejnými parametry. Oproti manuálu PDFlib se mohou lišit pouze návratové hodnoty, protože byla převzata konvence PHP pro vracení FALSE was adopted. Z důvodu kompatibility toto rozšíření PDFlib stále podporuje staré funkce, ale tyto by měly být nahrazeny jejich novějšími verzemi. PDFlib GmbH nepomáhá s řešením žádných problémů plynoucích z používání těchto zastaralých funkcí.
Tabulka 1. Zastaralé funkce a jejich náhrady
Stará funkce | Náhrada |
---|---|
pdf_put_image() | Není potřeba. |
pdf_execute_image() | Není potřeba. |
pdf_get_annotation() | pdf_get_bookmark() se stejnými parametry. |
pdf_get_font() | pdf_get_value() s "font" jako druhý argument. |
pdf_get_fontsize() | pdf_get_value() s "fontsize" jako druhý argument. |
pdf_get_fontname() | pdf_get_parameter() s "fontname" jako druhý argument. |
pdf_set_info_creator() | pdf_set_info() s "Creator" jako druhý argument. |
pdf_set_info_title() | pdf_set_info() s "Title" jako druhý argument. |
pdf_set_info_subject() | pdf_set_info() s "Subject" jako druhý argument. |
pdf_set_info_author() | pdf_set_info() s "Author" jako druhý argument. |
pdf_set_info_keywords() | pdf_set_info() s "Keywords" jako druhý argument. |
pdf_set_leading() | pdf_set_value() s "leading" jako druhý argument. |
pdf_set_text_rendering() | pdf_set_value() s "textrendering" jako druhý argument. |
pdf_set_text_rise() | pdf_set_value() s "textrise" jako druhý argument. |
pdf_set_horiz_scaling() | pdf_set_value() s "horizscaling" jako druhý argument. |
pdf_set_text_matrix() | neexistuje |
pdf_set_char_spacing() | pdf_set_value() s "charspacing" jako druhý argument. |
pdf_set_word_spacing() | pdf_set_value() s "wordspacing" jako druhý argument. |
pdf_set_transition() | pdf_set_parameter() s "transition" jako druhý argument. |
pdf_open() | pdf_new() plus následné zavolání pdf_open_file() |
pdf_set_font() | pdf_findfont() plus následné zavolání pdf_setfont() |
pdf_set_duration() | pdf_set_value() s "duration" jako druhý argument. |
pdf_open_gif() | pdf_open_image_file() s "gif" jako druhý argument. |
pdf_open_jpeg() | pdf_open_image_file() s "jpeg" jako druhý argument. |
pdf_open_tiff() | pdf_open_image_file() s "tiff" jako druhý argument. |
pdf_open_png() | pdf_open_image_file() s "png" jako druhý argument. |
pdf_get_image_width() | pdf_get_value() s "imagewidth" jako druhý argument a obrázkem jako třetí argument. |
pdf_get_image_height() | pdf_get_value() s "imageheight" jako druhý argument a obrázkem jako třetí argument. |
Většina funkcí se používá docela snadno. Nejtěžší je zřejmě vůbec nějaký jednoduchý PDF dokument vůbec vytvořit. Následující ukázka by měla pomoci začít. Vytvoří soubor test.pdf s jednou stránkou. Tato stránka obsahuje text "Times Roman outlined" napsaný 30ti bodovým obrysem. Text je také podtržený.
Distribuce pdflib obsahuje rozsáhlejší ukázku, která obsahuje sérii stránek s analogovými hodinami. Tato ukázka převedená do PHP vypadá takto (stejnou ukázku najdete v dokumentaci k clibpdf modulu):
Příklad 3. pdfclock ukázka z pdflib distribuce
|
Poznámka: Existuje další PHP modul na tvorbu PDF dokumentů, založený na ClibPDF od firmy FastIO. Detaily viz ClibPDF funkce. Má mírně jinou API.
Předcházející | Domů | Další |
preg_split | Nahoru | PDF_activate_item |