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制作会社様向け業務案内、一般企業様向け業務案内もご覧くださいね。
Google OAuth 2.0で実装するPHP SSO入門：Google Cloud 設定と実装コード例
2025.11.24
Google OAuth 2.0 を利用した Google アカウントによる SSO を PHP で実装する手順を解説します。Google Cloud Console での OAuth 同意画面とクライアント作成、必要なスコープ設定から、Composer の導入、GSI（Google Sign‑In）ボタンの設置、ログインスクリプトの実装例までを一貫して扱います。
漏洩パスワードとの照合：Pwned Passwords APIの仕組みと実運用での注意点
2025.11.06
Pwned Passwords API（Have I Been Pwned）が採用する k‑Anonymity の仕組みを分かりやすく解説し、PHPによる実装例を通して漏洩パスワードチェックの具体手順を示します。さらに、ユーザー通知文面の注意点など、実運用で押さえるべきセキュリティと運用上の留意点をまとめています。
Composerオートローダーでの「Class not found」エラー対処法
2025.10.18
Composerを利用してPHPライブラリをインストールした後に発生する「Class not found」エラーの原因と、その対処法について解説しています。特に、オートローダーの設定が正しく機能していない場合の具体的なエラー例を基に手順を紹介。
PHPで実現するCloud Vision API OCR入門：画像からテキスト抽出の基本
2025.09.30
Google Cloud Vision API を利用して、PHP で画像からテキストを抽出する OCR 処理の基本的な実装方法を解説します。API の有効化や認証情報の取得、PHP クライアントライブラリのインストール手順から、実際のコード例に基づいた OCR 処理の流れを紹介。