この記事では、PHP を使用して PDF ファイルを生成する方法について説明します。 TCPDF ライブラリを使用してプログラムで PDF ドキュメントを作成します。
ユーザーが注文受領書、請求書、請求書などの文書をダウンロードまたは印刷できる Web サイトを開発している場合、いくつかのオプションがあります。ドキュメントをブラウザでインラインで表示することも、ダウンロード用に提供することもできます。 PDF はドキュメントのダウンロードに最適な形式の 1 つであり、テキストの書式を保持するのに優れています。
つまり、PHP Web サイトで PDF ファイルを生成する方法を学びたい場合は、ここが正しい場所です。
このセクションでは、TCPDF ライブラリをインストールする方法を学習します。
TCPDF ライブラリをサーバーにインストールするには、複数の方法があります。 TCPDF ライブラリは Packagist および GitHub で入手できるため、Composer を使用することも、GitHub からクローンを作成することもできます。今回の場合は、Composer を使用してインストールします。
次のコマンドの実行に進み、Composer を使用して TCPDF ライブラリをインストールします。
リーリーインストールが成功したら、次のコード スニペットに示すように、PHP スクリプトに autoload.php ファイルを含める必要があります。
リーリーこれにより、TCPDF ライブラリが提供するすべてのユーティリティ メソッドを使用できるようになります。
このセクションでは、PDF 請求書を生成する方法を示す実践的な例を構築します。 TCPDF ライブラリには、PDF ドキュメントを生成するための参照として使用できる既製のテンプレートが多数用意されています。ただし、請求書は最初から作成させていただきます。
前のセクションですでに述べたように、TCPDF ライブラリには、ヘッダーとフッターを備えた汎用 PDF ファイルを生成できる既製のテンプレートが多数用意されています。これは、デフォルトの形式と設定に満足している場合に便利です。ただし、コンテンツだけでなくヘッダーとフッターもカスタマイズしたい場合は、TCPDF
クラスを拡張し、対応するメソッドをオーバーライドする必要があります。
この例では、customPdfGenerator.php と example.php という 2 つのファイルを作成します。 customPdfGenerator.php ファイルで、コアの TCPDF
クラスを拡張し、いくつかのメソッドをオーバーライドする CustomPdfGenerator
クラスを作成します。 example.php ファイルでは、CustomPdfGenerator
クラスの使用方法を示します。
CustomPdfGenerator
クラス次の内容を含む customPdfGenerator.php ファイルの作成に進みます。
リーリーCustomPdfGenerator
クラスは TCPDF
クラスを拡張するため、TCPDF
クラスが提供するすべてのユーティリティ メソッドを使用して書式設定やフォーマットを行うことができることに注意してください。 PDFドキュメントを生成します。
TCPDF クラスを直接使用する代わりに独自のクラスを作成する唯一の目的は、組み込みのヘッダーおよびフッター コンポーネントを使用したくないことです。したがって、クラス内の
header メソッドと
footer メソッドをオーバーライドします。
メソッド
リーリー
まず、Image メソッドを使用して、左側に会社のロゴを描画します。重要なのは、ロゴ画像への絶対パスをImage メソッドに渡す必要があることです。次に、SetFont メソッドを使用して、タイトルに追加されるテキストのフォント ファミリーとフォント サイズを設定します。最後に、
Cell メソッドを使用して、右側に所有者名を出力します。
上記の設定により、タイトルは次のようになります:
フッターメソッド
Footer メソッドは次のコード スニペットに示すように非常に簡単です。
リーリー
最後に
printTable メソッドがあります。このメソッドについては後で説明します。
printTable メソッドは、
TCPDF クラスとは何の関係もありません。代わりに、プロジェクト情報を表示するテーブルを描画するために使用するカスタム ユーティリティ メソッドを使用します。
CustomPdfGenerator クラスです。次のセクションでは、その使用方法と完全な PDF 請求書を生成するその他の方法を見ていきます。
CustomPdfGenerator ラッパー クラスを作成しました。このセクションでは、その使用方法を説明します。
example.php ファイルの作成に進みます。 リーリー
上記のファイルの重要なスニペットを見てみましょう。まず、
autoload.php ファイルを追加して、TCPDF クラスが自動的にロードされるようにします。次に、カスタム クラスをロードするために
customPdfGenerator.php ファイルを追加しました。
接下来,我们实例化了 CustomPdfGenerator
类以及默认设置。在实际开始写入 PDF 文件之前,我们还调用了一些方法来进行默认设置。
$pdf = new CustomPdfGenerator(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false); $pdf->SetDefaultMonospacedFont(PDF_FONT_MONOSPACED); $pdf->SetMargins(PDF_MARGIN_LEFT, PDF_MARGIN_TOP, PDF_MARGIN_RIGHT); $pdf->SetAutoPageBreak(TRUE, PDF_MARGIN_BOTTOM); $pdf->setImageScale(PDF_IMAGE_SCALE_RATIO); $pdf->setFontSubsetting(true); $pdf->SetFont('dejavusans', '', 12, '', true);
我们在上面代码片段中使用的常量已在 tcpdf_autoconfig.php 文件中定义。要覆盖这些常量之一,您只需在脚本中定义它,TCPDF 库将使用您的值。例如,PDF_PAGE_ORIENTATION
常量的默认值为 P
(纵向),如果要将其更改为 L
(横向),则只需包含 define ('PDF_PAGE_ORIENTATION', 'L ');脚本中的
。
接下来,有一个重要的片段,它调用 AddPage
方法,该方法实际上在 PDF 文档中添加一个新页面。
// start a new page $pdf->AddPage();
现在我们已经添加了一个页面,我们可以开始在此页面上书写。
接下来,我们使用 Write
和 writeHTML
方法在左侧打印日期和发票号码。
// date and invoice no $pdf->Write(0, "\n", '', 0, 'C', true, 0, false, false, 0); $pdf->writeHTML("<b>DATE:</b> 01/01/2021"); $pdf->writeHTML("<b>INVOICE#</b>12"); $pdf->Write(0, "\n", '', 0, 'C', true, 0, false, false, 0);
Write
方法从当前位置开始打印文本,您可以使用它来打印纯文本。另一方面, writeHTML
方法允许您保留文本中的 HTML 格式。虽然 writeHTML
方法提供了有限的 HTML 格式支持,但它涵盖了日常开发中经常使用的所有 HTML 标签。
同样,我们在 writeHTML
方法的帮助下打印了地址和收单地址。
// address $pdf->writeHTML("84 Norton Street,"); $pdf->writeHTML("NORMANHURST,"); $pdf->writeHTML("New South Wales, 2076"); $pdf->Write(0, "\n", '', 0, 'C', true, 0, false, false, 0); // bill to $pdf->writeHTML("<b>BILL TO:</b>", true, false, false, false, 'R'); $pdf->writeHTML("22 South Molle Boulevard,", true, false, false, false, 'R'); $pdf->writeHTML("KOOROOMOOL,", true, false, false, false, 'R'); $pdf->writeHTML("Queensland, 4854", true, false, false, false, 'R'); $pdf->Write(0, "\n", '', 0, 'C', true, 0, false, false, 0);
默认情况下,writeHTML
方法在左侧打印文本。如果要打印右对齐文本,可以传递 R
作为 writeHTML
方法的最后一个参数,如上面的代码片段所示。在我们的例子中,我们希望显示右对齐的收单地址。
让我们快速浏览一下到目前为止我们已经构建的内容。
接下来,我们有一个代码片段,它负责打印项目信息表的繁重工作。
// invoice table starts here $header = array('DESCRIPTION', 'UNITS', 'RATE $', 'AMOUNT'); $data = array( array('Item #1','1','100','100'), array('Item #2','2','200','400') ); $pdf->printTable($header, $data); $pdf->Ln();
还记得我们在customPdfGenerator.php类中定义的printTable
方法吗?现在是时候详细探讨它了。让我们拉入 printTable
方法的代码。
public function printTable($header, $data) { $this->SetFillColor(0, 0, 0); $this->SetTextColor(255); $this->SetDrawColor(128, 0, 0); $this->SetLineWidth(0.3); $this->SetFont('', 'B', 12); $w = array(110, 17, 25, 30); $num_headers = count($header); for($i = 0; $i < $num_headers; ++$i) { $this->Cell($w[$i], 7, $header[$i], 1, 0, 'C', 1); } $this->Ln(); // Color and font restoration $this->SetFillColor(224, 235, 255); $this->SetTextColor(0); $this->SetFont(''); // table data $fill = 0; $total = 0; foreach($data as $row) { $this->Cell($w[0], 6, $row[0], 'LR', 0, 'L', $fill); $this->Cell($w[1], 6, $row[1], 'LR', 0, 'R', $fill); $this->Cell($w[2], 6, number_format($row[2]), 'LR', 0, 'R', $fill); $this->Cell($w[3], 6, number_format($row[3]), 'LR', 0, 'R', $fill); $this->Ln(); $fill=!$fill; $total+=$row[3]; } $this->Cell($w[0], 6, '', 'LR', 0, 'L', $fill); $this->Cell($w[1], 6, '', 'LR', 0, 'R', $fill); $this->Cell($w[2], 6, '', 'LR', 0, 'L', $fill); $this->Cell($w[3], 6, '', 'LR', 0, 'R', $fill); $this->Ln(); $this->Cell($w[0], 6, '', 'LR', 0, 'L', $fill); $this->Cell($w[1], 6, '', 'LR', 0, 'R', $fill); $this->Cell($w[2], 6, 'TOTAL:', 'LR', 0, 'L', $fill); $this->Cell($w[3], 6, $total, 'LR', 0, 'R', $fill); $this->Ln(); $this->Cell(array_sum($w), 0, '', 'T'); }
首先,在实际开始打印发票表的标题行之前,我们调用了几个方法来设置字体大小、填充颜色、线宽和文本颜色。接下来,我们在 Cell
方法的帮助下循环遍历 $header
数组并打印表头标题。
Cell
方法允许您打印具有可选边框、背景颜色和字符串的单元格(矩形区域)。您还可以指定在单元格中打印的文本的对齐方式。因此,Cell
方法是构建表的完美候选方法。
打印表格标题标题后,我们循环遍历 $data
数组并打印它以完成整个表格。最后,我们多次调用 Cell
方法来打印总金额。
表格的快速预览应如下所示:
现在,让我们回到 example.php 文件来查看最后几行代码。
在发票末尾,我们将打印一些评论和联系信息,如以下代码片段所示。
// comments $pdf->SetFont('', '', 12); $pdf->writeHTML("<b>OTHER COMMENTS:</b>"); $pdf->writeHTML("Method of payment: <i>PAYPAL</i>"); $pdf->writeHTML("PayPal ID: <i>katie@paypal.com"); $pdf->Write(0, "\n\n\n", '', 0, 'C', true, 0, false, false, 0); $pdf->writeHTML("If you have any questions about this invoice, please contact:", true, false, false, false, 'C'); $pdf->writeHTML("Katie A Falk, (07) 4050 2235, katie@sks.com", true, false, false, false, 'C');
最后,我们使用 Output
方法将 PDF 文件保存到磁盘。如果您不想将 PDF 文件保存在磁盘上,而只想将其发送到浏览器,则需要在 Output
方法的第二个参数中使用 I
。
继续运行 example.php
文件,它应该生成如下屏幕截图所示的 PDF 文件。
这就是如何使用 TCPDF 库在 PHP 中创建 PDF 文档。我们创建了一个真实示例来演示 TCPDF 库提供的一些不同的 API。
TCPDF 官方文档提供了许多现成的模板,您可以探索它们以了解内置 API,我鼓励您探索它!
如果您想了解有关在网站中包含 PDF 的更多信息,请查看以下链接:
以上がPHPでPDFファイルを生成する方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。