導入

Thomas Merzによるpdfライブラリをインストールしている場合、PHPで pdfファイルを作成するために pdf 関数を使用することができます。 (http://www.pdflib.com/pdflib/index.html で取得可能です。)コンパ イルにはJPEGライブラリおよび TIFFライブラリも必要です。 これら2つのライブラリは、PHP の configure を実行する際にもしばしば 問題を発生します。問題を修正するには、configureのメッセージに従っ て下さい。

pdflibのソース配布ファイルと共に配布されているpdflibに関する素晴 らしいドキュメントを参照して下さい。この文書は、pdflib の機能に関 する概要を良くまとめています。pdflibのほとんどの関数とPHPモジュー ル内の関数の名前は共通になっています。パラメータも同じです。 このモジュールを効率的に使用するには、pdfまたはPostscriptの おおよその考え方も理解しておく必要があります。全ての長さと座標は Postscriptのポイント数で計られます。通常、1インチ当たり 72 Postscript ポイントですが、これは、出力解像度に依存します。

FastIOが作成した Clibpdfを使用したpdfドキュメント作成用の別のPHPモジュールがあります。 このライブラリのAPIは、やや異なっています。詳細は、 Clibpdf 関数の節をご覧下さい。

pdfモジュールは、pdf object という変数の型 を新規に導入します。ほとんど全ての関数は、最初の引数パラメータと して pdf object を必要とします。

古いバージョンのpdflibとの混乱

PHP v4.0.5以降、PHPlib用のPHP拡張モジュールは、PDFlib GmbH から正 式にサポートされています。これにより、PDFlibマニュアル(バージョン 3.00以降)に記述された全ての関数がPHP4で全く同じ意味、同じパラメー タでサポートされています。返り値のみは、エラーの場合に FALSE を返 すというPHPの流儀に合わせるためにPDFlibマニュアルと異なっているこ とがあります。互換性を保つためにPDFlibサポート関数ではまだ古い関数 もサポートしていますが、上記のように新しいバージョンに置換される予 定です。PDFlib GmbH は、これらの古い関数を使用した場合に生じた際に 生じた問題に関してはサポートを行いません。

PDFlib 3.xのインストールに関するヒント

PDFlibのバージョン3.0以降では、オプション --enable-shared-pdflibを付けてPDFlibの configureを行う必要があります。

PDFlibの過去のバージョンに関する問題

2000/3/9以降のバージョンのPHP 4は、3.0より前のバージョンのPDFlib はサポートしていません。

一方、PHP 3 では 2.01 より新しいバージョンを使用するべきではあり ません。ただし、php3/functions/pdf.c (PHP 3.0.19) のリビジョン 1.61 以降では、PDFlib 3.0 以降を使用可能です。

例

多くの関数の使用法は簡単です。最も困難なのは、非常に簡単なpdfドキュ メントを作成する場合でしょう。次の例は、入門の際の助けとなるはず です。この例では、1ページを有するファイル test.pdfが作成されます。このページには、30ポ イントのアウトラインフォントでテキスト"Times-Roman outlined"が描 かれます。このテキストには、下線も引かれます。

例 1PDFlibでPDFドキュメントを作成する <?php <?php $pdf = PDF_new(); PDF_open_file($pdf, "test.pdf"); PDF_set_info($pdf, "Author", "Uwe Steinmann"); PDF_set_info($pdf, "Title", "Test for PHP wrapper of PDFlib 2.0"); PDF_set_info($pdf, "Creator", "See Author"); PDF_set_info($pdf, "Subject", "Testing"); PDF_begin_page($pdf, 595, 842); PDF_add_outline($pdf, "Page 1"); PDF_set_font($pdf, "Times-Roman", 30, "host"); PDF_set_value($pdf, "textrendering", 1); PDF_show_xy($pdf, "Times Roman outlined", 50, 750); PDF_moveto($pdf, 50, 740); PDF_lineto($pdf, 330, 740); PDF_stroke($pdf); PDF_end_page($pdf); PDF_close($pdf); PDF_delete($pdf); echo "<A HREF=getpdf.php>完了しました</A>"; ?> 以下のスクリプトgetpdf.phpは、PDFドキュメ ントを返すだけのものです。 <?php $len = filesize($filename); header("Content-type: application/pdf"); header("Content-Length: $len"); header("Content-Disposition: inline; filename=foo.pdf"); readfile($filename); ?>

PDFlibの配布ファイルには、アナログクロックで本格的なページを作成す るより複雑な例が含まれています。ここでは、PDFlibのメモリ内作成機 能を使用しており、このため、テンポラリファイルは不要です。この例 をPHPからPDFlibを使用するように変換すると以下のようになります。 (clibpdfモジュール)のドキュメント にも同じ例があります。)

例 2PDFlib配布ファイル中の pdfclockの例 <?php $radius = 200; $margin = 20; $pagecount = 10; $pdf = PDF_new(); if (!PDF_open_file($pdf, "")) { print error; exit; }; PDF_set_parameter($pdf, "warning", "true"); PDF_set_info($pdf, "Creator", "pdf_clock.php"); PDF_set_info($pdf, "Author", "Uwe Steinmann"); PDF_set_info($pdf, "Title", "Analog Clock"); while($pagecount-- > 0) { PDF_begin_page($pdf, 2 * ($radius + $margin), 2 * ($radius + $margin)); PDF_set_parameter($pdf, "transition", "wipe"); PDF_set_value($pdf, "duration", 0.5); PDF_translate($pdf, $radius + $margin, $radius + $margin); PDF_save($pdf); PDF_setrgbcolor($pdf, 0.0, 0.0, 1.0); /* 1分刻みの目盛 */ PDF_setlinewidth($pdf, 2.0); for ($alpha = 0; $alpha < 360; $alpha += 6) { PDF_rotate($pdf, 6.0); PDF_moveto($pdf, $radius, 0.0); PDF_lineto($pdf, $radius-$margin/3, 0.0); PDF_stroke($pdf); } PDF_restore($pdf); PDF_save($pdf); /* 5分刻みの目盛 */ PDF_setlinewidth($pdf, 3.0); for ($alpha = 0; $alpha < 360; $alpha += 30) { PDF_rotate($pdf, 30.0); PDF_moveto($pdf, $radius, 0.0); PDF_lineto($pdf, $radius-$margin, 0.0); PDF_stroke($pdf); } $ltime = getdate(); /* 時針を描画 */ PDF_save($pdf); PDF_rotate($pdf,-(($ltime['minutes']/60.0)+$ltime['hours']-3.0)*30.0); PDF_moveto($pdf, -$radius/10, -$radius/20); PDF_lineto($pdf, $radius/2, 0.0); PDF_lineto($pdf, -$radius/10, $radius/20); PDF_closepath($pdf); PDF_fill($pdf); PDF_restore($pdf); /* 分針を描画 */ PDF_save($pdf); PDF_rotate($pdf,-(($ltime['seconds']/60.0)+$ltime['minutes']-15.0)*6.0); PDF_moveto($pdf, -$radius/10, -$radius/20); PDF_lineto($pdf, $radius * 0.8, 0.0); PDF_lineto($pdf, -$radius/10, $radius/20); PDF_closepath($pdf); PDF_fill($pdf); PDF_restore($pdf); /* 秒針を描画 */ PDF_setrgbcolor($pdf, 1.0, 0.0, 0.0); PDF_setlinewidth($pdf, 2); PDF_save($pdf); PDF_rotate($pdf, -(($ltime['seconds'] - 15.0) * 6.0)); PDF_moveto($pdf, -$radius/5, 0.0); PDF_lineto($pdf, $radius, 0.0); PDF_stroke($pdf); PDF_restore($pdf); /* 中心に小さな円を描画 */ PDF_circle($pdf, 0, 0, $radius/30); PDF_fill($pdf); PDF_restore($pdf); PDF_end_page($pdf); /* 変化を見るために待つ */ sleep(1); } PDF_close($pdf); $buf = PDF_get_buffer($pdf); $len = strlen($buf); header("Content-type: application/pdf"); header("Content-Length: $len"); header("Content-Disposition: inline; filename=foo.pdf"); print $buf; PDF_delete($pdf); ?>