PHPでmPDFを使ってHTMLをPDFに変換する方法
作成日:2025.02.07
PHPのライブラリmPDFを使用して、HTMLドキュメントをPDFとして出力する方法を詳しく解説します。インストールから日本語対応まで、具体的なコード例を交えて説明します。
error この記事は最終更新日から1年以上が経過しています。
目次
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を生成するシステムの開発や、帳票出力機能の実装に関するサポートを承っております。
奈良市を拠点に、27年以上の経験を持つフリーランスWebエンジニア、阿部辰也です。
これまで、ECサイトのバックエンド開発や業務効率化システム、公共施設の予約システムなど、多彩なプロジェクトを手がけ、企業様や制作会社様のパートナーとして信頼を築いてまいりました。
【制作会社・企業様向けサポート】
Webシステムの開発やサイト改善でお困りの際は、どうぞお気軽にご相談ください。小さな疑問から大規模プロジェクトまで、最適なご提案を心を込めてさせていただきます。
ぜひ、プロフィールやWeb制作会社様向け業務案内、一般企業様向け業務案内もご覧くださいね。
mPDFでPDFが開けない・出力できないときの確認方法：BOM・空白・警告を切り分ける
2026.11.07
mPDFで出力済みエラーが出たり、PDFが開けなかったりするときに、生成処理とHTTPでの返却を分けて原因を調べる方法を紹介します。BOM・空白・デバッグ出力・PHP警告の混入を比較し、出力バッファーやdebug設定による違い、ログで出力元を特定する手順を解説します。
mPDFで日本語PDFを生成する：フォント登録・改ページ・レイアウト崩れの確認ポイント
2026.09.23
PHPからmPDFで日本語を含むPDFや帳票を生成する際に、Noto Sans JPなどのフォントをプロジェクト側で登録する方法、fontDir・fontdata・tempDirの設定、HTML/CSSの制約、改ページや長い文字列の扱いを解説します。Linuxや本番環境で起きる文字化け・レイアウト崩れを、PHP拡張、フォント、権限、入力HTMLの観点から切り分ける手順も紹介します。
PhpSpreadsheetでExcelの日付・日時を読み込む：数値・文字列・空欄の扱い方
2026.11.06
PhpSpreadsheetでExcelの日付・日時を読み込み、取り込み先の形式へ変換する方法を解説します。セルの値・型・表示形式の違いを整理し、数値と文字列の混在、空欄、不正な日付、時刻部分を扱うPHPコードを紹介。1900・1904日付システムとタイムゾーンの注意点も確認します。
php -rの使い方：PowerShellでPHPを手軽に試す
2026.11.04
PHPファイルを作らずにコードを実行できる「php -r」の基本的な使い方を紹介します。PowerShellで変数や関数を試す例と、引用符による変数展開でエラーになる原因・対処法を説明し、Bashとの違いやPHPファイルへ切り出す目安も補足します。