技術資料

PHPのライブラリmPDFを使用して、HTMLドキュメントをPDFとして出力する手順を解説します。

mPDFのインストール

まずは、mPDFをインストールします。Composerを使用してインストールする場合は、以下のコマンドを実行します。

composer require mpdf/mpdf

※Composer自体のインストールについては、XAMPP環境にComposerをインストールする方法を参照。

テストコードの実行

以下のコードを実行すると、HTMLドキュメントをPDFとして出力できます。

require_once __DIR__ . '/vendor/autoload.php';

$mpdf = new \Mpdf\Mpdf();
$mpdf->WriteHTML('<h1>Hello world!</h1>');
$mpdf->Output();

PDFファイルをダウンロードさせる

上記の例ではPDFをそのまま出力しますが、ダウンロードダイアログを出して、ユーザーにPDFファイルをダウンロードさせるには、以下のようにします。

$mpdf->Output('filename.pdf','D');
// または
$mpdf->Output('filename.pdf',\Mpdf\Output\Destination::DOWNLOAD);
// mPDFハージョン8.1.2以上では
$mpdf->OutputHttpDownload('filename.pdf');

PDFのプロパティで表示される各種情報を設定する

PDFのプロパティで表示される各種情報（著者、作成者、タイトル、サブジェクト、キーワード）を設定するには、以下のようにします。

$mpdf = new \Mpdf\Mpdf();
$mpdf->SetAuthor('Tatsuya Abe');
$mpdf->SetCreator('Application Name');
$mpdf->SetTitle('Document Title');
$mpdf->SetSubject('Subject');
$mpdf->SetKeywords('Keyword1, Keyword2');
$mpdf->WriteHTML('<h1>Hello world!</h1>');
$mpdf->OutputHttpDownload('filename.pdf');

ダウンロードしたPDFファイルのプロパティを見ると以下のように設定されているのが確認できます。

日本語を出力する

まずは試しに日本語をそのまま出力してみます。

$mpdf = new \Mpdf\Mpdf();
$mpdf->WriteHTML('<h1>こんにちは</h1>');
$mpdf->Output();

mPDFは初期状態では日本語に対応したフォントが指定されていないので、以下のスクリーンショットのように、日本語は文字化けしてしまうと思います。

というわけで、日本語に対応したフォントを指定する必要があります。

mPDFで使用するフォントファイルは、vendor/mpdf/mpdf/ttfonts に入っています。ここに、日本語に対応したフォントの ttfファイルを入れます。

今回は、Google Fonts の Noto Sans JPの ttfファイルをダウンロードして使ってみます。

NotoSansJP-Regular.ttf を vendor/mpdf/mpdf/ttfonts のディレクトリに入れておき、以下のようにフォントを指定して mPDF を実行。

$mpdf = new \Mpdf\Mpdf([
	'fontdata' => [
		'notosansjp' => [
			'R' => 'NotoSansJP-Regular.ttf',
		],
		'default_font' => 'notosansjp'
	],
]);
$mpdf->WriteHTML('<h1>こんにちは</h1>');
$mpdf->Output();

これで、日本語が出力できます。

mPDFが対応しているHTMLやCSS

mPDFが対応しているHTMLやCSSは、以下のドキュメントを参照。

• HTML Tags - HTML support - mPDF Manual
• HTML Attributes - HTML support - mPDF Manual
• Supported CSS - CSS & Stylesheets - mPDF Manual

mPDFは結構古いライブラリなので、flexboxやgridのようなレイアウト手法には対応していません。ある程度凝ったレイアウトを実現するには、懐かしの float: left; とかでレイアウトするか、いにしえのテーブルレイアウトなどを採用する必要があります。

とはいえ、PHPで動的にPDFを出力したいというニーズは、帳票などの出力がメインとなると思うので、むしろ帳票ならテーブルタグを使うのが本来の形のような気もします。