PHPでmPDFを使ってHTMLをPDFに変換する方法
作成日:2025.02.07
PHPのライブラリmPDFを使用して、HTMLドキュメントをPDFとして出力する方法を詳しく解説します。インストールから日本語対応まで、具体的なコード例を交えて説明します。
目次
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を出力したいというニーズは、帳票などの出力がメインとなると思うので、むしろ帳票ならテーブルタグを使うのが本来の形のような気もします。
mPDFを利用したPDF出力に関するサポートが必要な方へ
本記事でご紹介したmPDFライブラリを使ったHTMLからPDFへの出力方法や、特に日本語の文字化け対応、フォント設定についての実装でお困りの方は、お気軽にご相談ください。
PHPで動的にPDFを生成するシステムの開発や、帳票出力機能の実装に関するサポートを承っております。
奈良市を拠点に、26年以上の経験を持つフリーランスWebエンジニア、阿部辰也です。
これまで、ECサイトのバックエンド開発や業務効率化システム、公共施設の予約システムなど、多彩なプロジェクトを手がけ、企業様や制作会社様のパートナーとして信頼を築いてまいりました。
【制作会社・企業様向けサポート】
Webシステムの開発やサイト改善でお困りの際は、どうぞお気軽にご相談ください。小さな疑問から大規模プロジェクトまで、最適なご提案を心を込めてさせていただきます。
ぜひ、プロフィールやWeb制作会社様向け業務案内、一般企業様向け業務案内もご覧くださいね。
OpenAI API 実践例：Chat Completions API で JSON形式レスポンスを取得する方法
2025.06.04
OpenAI API の Chat Completions API を用いて、レスポンス形式を JSON に固定する実装手法を紹介します。PHP を使った具体的なコード例を通じ、response_format パラメータの設定方法や利用シーン、最新モデルでのオプション利用まで解説しています。
CodeIgniter 4 クエリビルダ入門 ― 実践的なデータ操作とSQL組み立てのテクニック
2025.05.30
CodeIgniter 4 のクエリビルダの基本から実践的な利用方法までを、具体的なコード例とともに解説します。単純な条件指定から複雑なAND/ORや部分一致検索、IN句など、さまざまな使い方を段階的に学ぶことができます。これにより、SQL文を直接記述せずに柔軟なデータ操作が可能になる手法をご紹介します。
CodeIgniter 4 フォーム入力バリデーション入門 ― 基本操作とカスタマイズ手法
2025.04.06
CodeIgniter 4でのフォーム入力値取得とバリデーション処理を、シンプルな実装例を通して解説します。基本的なルール設定から、エラーメッセージの出力、フォームラベルの日本語化やローカライズ方法まで、実践的なテクニックをコンパクトにまとめています。
PHPによる OpenAI TTS API 実装ガイド ― GPT-4o mini TTSでテキストを音声に変換
2025.04.05
本記事では、最新の OpenAI TTS モデル「GPT-4o mini TTS」を利用し、PHPでテキストを自然な音声に変換する実装手法を詳しく解説します。curl を用いたリクエスト送信、JSON形式のパラメータ設定、ファイル出力処理まで、実際のサンプルコードを交えながら、各工程のポイントとパラメータの意味について解説。