Rapid Express

Tabsメニューをみた通り、Windows MobileやWindowsツールの話題が中心で、ブログタイトルに直接関係したエントリーがほとんどありません。ということで、ここらで一つPHPのライブラリのネタを立てておこうかと思います。

?

で、PDFを扱うフリーのPHPライブラリにはFPDFがありますが、その導入について決定的だと思えるブログ記事がないように思えないので、これをエントリーとします。

何を持ってそう思うかというと、まず、このライブラリを使いこなすには最低限次の3つが必須だと思うのですが、これをセットで紹介している記事は少ないこと。

1. 日本語対応の拡張クラス
2. 差込印刷のためのテンプレート拡張クラス
3. 文字回転の拡張クラス

そして、日本語対応クラスにはjapanese.zipとMBFPDFの２つがあるのですが、どちらを使うべきか断じていないことです。

結論を言えば、MBFPDFを使うべきで、３つの拡張クラスを紹介している記事があってもjapanese.zipをベースにしている点で不足していたりしました。

fpdf.orgでJapanse supportをクリックすると、筆頭にはOliver氏自身による japanese.zip があり、おまけの「代替エクステンション」としてMBFPDFに外部リンクが張ってあります。これだと、権威に弱い日本人は 正規配布品に目が行きがちです。

中身を見れば一目瞭然ですが、japanese.zipは日本語対応のサンプル程度の完成度で、フォントはP明朝しか扱えません。ほかのフォントが必要ならコードを真似して追加する必要がありますが、その方法を紹介する記事は見当たりません。

なぜ無いか？・・・簡単なことです。MBFPDFを使えば最初から明朝、P明朝、ゴシック、Pゴシックが扱えるので、誰も（すでに実務で利用している人は）そんな面倒なことをしてないからです。

?

2番目の差込印刷クラスですが、何か特別な機能のように考える方もおられるかもしれませんが、罫線を含めたすべての出力をPHPで作成するのは現実的ではなく、あらかじめ作成したテンプレートPDFに動的文字だけを重ね合わるのが賢明です。
PDF作成には、Open Office.org CalcまたはDrowがあれば他にツールは必要ありませんし、相性もよいようです。Excel+Acrobatなどで作成したPDFを私自身は試していませんが、Open Office.org以外のPDFとの相性に問題があるとレポートしているWeb記事もあります。

文字回転クラスは縦書きで印刷するとき以外にも、用紙を横配置したときにも必要になります。小さなライブラリですから、常に組み込んでおくことに異論はないでしょう。

?

FPDFのインストール手順

■インストール先

今回のように、パッケージシステムに依存しないアプリケーションを自分でインストールする場所は、FHS標準規格では /usr/local 以下?です。/usr/local/lib/php が存在しますので、サブディレクトリにfpdfまたはpdfを作ってインストールします。

/usr/local/lib/php/fpdf

?

■ダウンロードするファイル

ダウンロードするのは以下の通りです。すべて /usr/local/lib/php/fpdf に（それ以上サブディレクトリを作らず）解凍します。

?

?

■ファイルの修正

MBFPDF, Rotations, FPDIはそれぞれが並列したFPDFの拡張クラスとして、たとえばMBFPDFをインクルードすればFPDFがインクルードされたことになるように書かれています。
これをMBFPDFをインクルードしたら残りのすべてが使用できるよう、紐付けを書き直します。FPDIからはデフォルトのままなので修正するのは次の赤矢印の部分です。

MBFPDF → Rotations → FPDI → FPDF_TPL → FPDF

?

MBFPDF

11: require('fpdf.php'); ? ? ? ? ? ?// Original Class
 ：
40: class MBFPDF extends FPDF

以下に修正

11: require('fpdf.php');            // Original Class
12: require('rotation.php');        // ★追加
 ：
41: class MBFPDF extends PDF_Rotate // ★修正

rotation.php

2: require('fpdf.php');
3:
4: class PDF_Rotate extends FPDF

以下に修正

2: require('fpdi.php');             // ★修正
3:
4: class PDF_Rotate extends FPDI    // ★修正

?

これでMBFPDFをインクルードすればすべてのライブラリが利用可能になります。このまま使用しても良いのですが、自分なりの用途にあわせて専用クラスを作成すると使いやすくなります。

?

■ユーザーPDFクラス

年賀状印刷用に作成したPDF出力クラスです。

あて名書きでは、横書き（text_horizontal）、縦書き（text_vertical）の他に、縦置き用紙に横書きするため90度回転（text_rotate）も必要とされ、縦書きでは数値の漢数字化と文字単位での270度回転や位置調整が必要でした。印字位置に収めるため、最大長に応じて文字サイズを自動調整するようにもしてあります。

何を印刷するにしても不足のないライブラリになっているのではないでしょうか。

pdf.inc.php

?

使い方は次のようになります。

<?php
define('MY_FPDF_PATH', '/usr/local/lib/php/fpdf');
define('MY_ENCODE', 'SJIS');

include_once 'class/pdf.inc.php';

// クラス初期化と用紙サイズ指定
//（引数と省略時の初期値）
// $orientation="P", $unit="mm", $format="A4", $families=array(PMINCHO)
$o_pdf = new my_class_pdf("P", "mm", "Postcard", array(GOTHIC, PGOTHIC));

// ページ追加
// $family=PMINCHO, $template=""
$o_pdf->add_page(GOTHIC, "nenga.pdf");

// 水平
// $x, $y, $size, $text, $max_width=0, $align="left", $space=0, $style="", $family=""
$o_pdf->text_horizontal(46.2, 18.0, 13, "163", 0, "left", 4.6);
$o_pdf->text_horizontal(67.7, 18.0, 13, "8001",   0, "left", 4.6);

// 垂直
// $x, $y, $size, $text, $max_height=0, $valign="top", $space=0, $style="", $family=""
list($size) = $o_pdf->text_vertical(92, 30, 12, "東京都新宿区西新宿1-8-1", 90);
$o_pdf->text_vertical(86, 30, $size, "第一本庁舎15F北", 90, "bottom");
$o_pdf->text_vertical(76, 30, 15, "東京オリンピック・パラリンピック招致本部", 90);
$o_pdf->text_vertical(70, 40, 15, "招致推進部", 80);
list($size, $y) = $o_pdf->text_vertical(60, 30, 20, "東　京太郎　様", 90, "middle", 2, "B");
$o_pdf->text_vertical(50, $y, $size, "〓　花子　様", 0, "top", 2, "B");

// ２ページ目
$o_pdf->add_page(PGOTHIC, "nenga.pdf");

// 90度回転
$x = 50;
$o_pdf->text_rotate90($x, 100, 14, "President Barack H. Obama, Jr.", 70, "left", "B");
$x += 6;
$o_pdf->text_rotate90($x, 100, 11, "The White House", 70);
$x += 10;
$o_pdf->text_rotate90($x, 100, 11, "1600 Pennsylvania Avenue NW", 70);
$x += 5;
$o_pdf->text_rotate90($x, 100, 11, "Washington DC 20500, USA", 70);

// 出力
// $name="doc.pdf", $zone="default"
$o_pdf->output("address.pdf", "real");?
?>

出力結果です。

これはプレビュー用で、本番のあて名印刷ではテンプレートを省いて無地出力します。

調整後のフォントサイズと段落基点は返り値で得られるので、次の行のサイズと位置調整に利用できます。
サンプルでは、団体名がリサイズされ、連名がセンタリングしたあて名にそろっています。

投稿日 2009年01月12日 カテゴリ 未分類 • RSS 2.0 • コメント, トラックバック