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を生成する：フォント登録・改ページ・レイアウト崩れの確認ポイント
2026.09.23
PHPからmPDFで日本語を含むPDFや帳票を生成する際に、Noto Sans JPなどのフォントをプロジェクト側で登録する方法、fontDir・fontdata・tempDirの設定、HTML/CSSの制約、改ページや長い文字列の扱いを解説します。Linuxや本番環境で起きる文字化け・レイアウト崩れを、PHP拡張、フォント、権限、入力HTMLの観点から切り分ける手順も紹介します。
Laravelのコードレビューで遅いSQLの候補を洗い出す
2026.10.02
Laravelのコードレビューで、ループ内のDBアクセスやEloquentのN+1、大量取得、検索条件とインデックスなど、性能問題につながりやすい箇所を候補として洗い出します。Laravelで発行SQLと実行時間を確認し、MySQLのEXPLAINや実データに近い環境での計測へつなげる方法を紹介します。コードレビューだけではSQLの実行時間を断定できない点も説明します。
Windows 11でDocker Composeを使ってLaravel環境を作る：Container・Volume・Networkの基本
2026.10.01
Windows 11のDocker Desktop上に、DockerfileとDocker Composeを使ってLaravel・PHP・MySQL・Mailpitの開発環境を構築します。ImageとContainerの関係、Bind MountとNamed Volumeによるデータの保存、ポート公開とContainer間通信の違いを実例で確認。LaravelからMySQLへ接続するときに、localhostではなくService名を使う理由も説明します。
PHPでYAML設定を検証する：symfony/yamlとopis/json-schemaの使い方
2026.09.30
symfony/yamlでYAMLを読み込み、opis/json-schemaで必須項目や型、許可する値を検証する方法を紹介します。YAMLのマップをstdClassとして扱う方法や、空のobjectとarrayの違い、信頼できないYAMLを扱う際の注意点も解説します。