PHP 使用 TCPDF 製作並產生 PDF 報表

PHP

透過 TCPDF library 讓 PHP 產生 PDF 報表檔案,而且它還支援部份的網頁標準,讓我們能夠使用 HTML 建構內容,再搭配 CSS 調整內容樣式。

下載 TCPDF

至 GitHub - tecnickcom/TCPDF: Official clone of PHP library to generate PDF documents and barcodes 下載壓縮檔並解壓縮至網站根目錄,更名為 TCPDF。

程式範例

程式參考 /TCPDF/examples/:

  • 產生 PDF:example_001.php。
  • 自訂頁首與頁尾:example_003.php。

於網站根目錄新增 report-employees.php 如下程式:

<?php
// Include the main TCPDF library (search for installation path).
require_once('TCPDF/tcpdf.php');

// Extend the TCPDF class to create custom Header and Footer
// 自訂頁首與頁尾
class MYPDF extends TCPDF {
	//Page header
	public function Header() {
		// Set font
        $this->SetFont('msungstdlight', '', 10);

        // 公司與報表名稱
        $title = '
<h4 style="font-size: 20pt; font-weight: normal; text-align: center;">MIS 腳印股份有限公司</h4>

<table>
    <tr>
        <td style="width: 30%;"></td>
        <td style="border-bottom: 2px solid black; font-size: 20pt; font-weight: normal; text-align: center; width: 40%;">員工基本資料</td>
        <td style="width: 30%;"></td>
    </tr>
    <tr>
        <td colspan="3"></td>
    </tr>
</table>';


        /**
         * 標題欄位
         *
         * 所有欄位的 width 設定值均與「資料欄位」互相對應,除第一個 <td> width 須向左偏移 5px,才能讓後續所有「標題欄位」與「資料欄位」切齊
         * 最後一個 <td> 必須設定 width: auto;,才能將剩餘寬度拉至最寬
         * style 屬性可使用 text-align: left|center|right; 來設定文字水平對齊方式
         */

        $fields = '
<table cellpadding="1">
    <tr>
        <td style="border-bottom: 1px solid black; width: 95px;"> ID</td>
        <td style="border-bottom: 1px solid black; width: 90px;">Name</td>
        <td style="border-bottom: 1px solid black; width: 90px;">Sex</td>
        <td style="border-bottom: 1px solid black; width: 90px;">Birthday</td>
        <td style="border-bottom: 1px solid black; width: 90px;">Tel</td>
        <td style="border-bottom: 1px solid black; width: 90px;">Mobile</td>
        <td style="border-bottom: 1px solid black; width: auto;">Address</td> 
    </tr>
</table>';

        // 設定不同頁要顯示的內容 (數值為對應的頁數)
        switch ($this->getPage()) {
            case '1':
                // 設定資料與頁面上方的間距 (依需求調整第二個參數即可)
                $this->SetMargins(1, 50, 1);

                // 增加列印日期的資訊
                $html = $title . '
<table cellpadding="1">
    <tr>
        <td>列印日期:' . date('Y-m-d') . ' ' . date('H:i') . '</td>
        <td></td>
        <td></td>        
    </tr>
    <tr>
        <td colspan="3"></td>
    </tr>
</table>' .  $fields;
                break;
            // 其它頁
            default:
                $this->SetMargins(1, 40, 1);
                $html = $title . $fields;
        }
        
		// Title
        $this->writeHTMLCell(0, 0, '', '', $html, 0, 1, 0, true, '', true);
	}

	// Page footer
	public function Footer() {
		// Position at 15 mm from bottom
		$this->SetY(-15);
		// Set font
		$this->SetFont('helvetica', 'I', 8);
		// Page number
		$this->Cell(0, 10, 'Page '.$this->getAliasNumPage().'/'.$this->getAliasNbPages(), 0, false, 'R', 0, '', 0, false, 'T', 'M');
	}
}

// create new PDF document
$pdf = new MYPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false);

// set document information
$pdf->SetCreator(PDF_CREATOR);
$pdf->SetAuthor('Nicola Asuni');
$pdf->SetTitle('MIS 腳印 - 員工基本資料');
$pdf->SetSubject('TCPDF Tutorial');
$pdf->SetKeywords('TCPDF, PDF, example, test, guide');

// set default header data
$pdf->SetHeaderData(PDF_HEADER_LOGO, PDF_HEADER_LOGO_WIDTH, PDF_HEADER_TITLE.' 001', PDF_HEADER_STRING, array(0,64,255), array(0,64,128));
$pdf->setFooterData(array(0,64,0), array(0,64,128));

// set header and footer fonts
$pdf->setHeaderFont(Array(PDF_FONT_NAME_MAIN, '', PDF_FONT_SIZE_MAIN));
$pdf->setFooterFont(Array(PDF_FONT_NAME_DATA, '', PDF_FONT_SIZE_DATA));

// set default monospaced font
$pdf->SetDefaultMonospacedFont(PDF_FONT_MONOSPACED);

// set margins
// 版面配置 > 邊界
// $pdf->SetMargins(PDF_MARGIN_LEFT, PDF_MARGIN_TOP, PDF_MARGIN_RIGHT);
$pdf->SetMargins(1, 1, 1);

// 頁首上方與頁面頂端的距離
$pdf->SetHeaderMargin(PDF_MARGIN_HEADER);
// 頁尾上方與頁面底端的距離
$pdf->SetFooterMargin(PDF_MARGIN_FOOTER);

// set auto page breaks
// 自動分頁
$pdf->SetAutoPageBreak(TRUE, PDF_MARGIN_BOTTOM);

// set image scale factor
$pdf->setImageScale(PDF_IMAGE_SCALE_RATIO);

// set some language-dependent strings (optional)
if (@file_exists(dirname(__FILE__).'/lang/eng.php')) {
	require_once(dirname(__FILE__).'/lang/eng.php');
	$pdf->setLanguageArray($l);
}

// ---------------------------------------------------------

// set default font subsetting mode
$pdf->setFontSubsetting(true);

// Set font
// dejavusans is a UTF-8 Unicode font, if you only need to
// print standard ASCII chars, you can use core fonts like
// helvetica or times to reduce file size.
// $pdf->SetFont('dejavusans', '', 14, '', true);
// 中文字體名稱, 樣式 (B 粗, I 斜, U 底線, D 刪除線, O 上方線), 字型大小 (預設 12pt), 字型檔, 使用文字子集 
$pdf->SetFont('msungstdlight', '', 10);

// Add a page
// This method has several options, check the source code documentation for more information.
// 版面配置:P 直向 | L 橫向, 紙張大小 (必須大寫字母)
$pdf->AddPage('P', 'LETTER');

// set text shadow effect
// 文字陰影
// $pdf->setTextShadow(array('enabled'=>true, 'depth_w'=>0.2, 'depth_h'=>0.2, 'color'=>array(196,196,196), 'opacity'=>1, 'blend_mode'=>'Normal'));

// Set some content to print
// $html = <<<EOD
// <h1>Welcome to <a href="http://www.tcpdf.org" style="text-decoration:none;background-color:#CC0000;color:black;"> <span style="color:black;">TC</span><span style="color:white;">PDF</span> </a>!</h1>
// <i>This is the first example of TCPDF library.</i>
// <p>This text is printed using the <i>writeHTMLCell()</i> method but you can also use: <i>Multicell(), writeHTML(), Write(), Cell() and Text()</i>.</p>
// <p>Please check the source code documentation and other examples for further information.</p>
// <p style="color:#CC0000;">TO IMPROVE AND EXPAND TCPDF I NEED YOUR SUPPORT, PLEASE <a href="http://sourceforge.net/donate/index.php?group_id=128076">MAKE A DONATION!</a></p>
// EOD;

for ($i = 0; $i < 50; $i++) {
    /**
     * 資料欄位
     *
     * 所有欄位的 width 設定值均與「標題欄位」互相對應,除第一個 <td> width 須 -5px
     * 最後一個 <td> 必須設定 width: auto;,才能將剩餘寬度拉至最寬
     * style 屬性可使用 text-align: left|center|right; 來設定文字水平對齊方式
     */

    $html .= '
        <tr>
            <td style="line-height: 1.5; width: 90px;">102050' . $i . '</td>
            <td style="line-height: 1.5; width: 90px;">王' . $i . '傑</td>
            <td style="line-height: 1.5; width: 90px;">M</td>
            <td style="line-height: 1.5; width: 90px;">72-11-16</td>
            <td style="line-height: 1.5; width: 90px;">06-2600000</td>
            <td style="line-height: 1.5; width: 90px;">0952000000</td>
            <td style="line-height: 1.5; width: auto;">台南市安平區健康三街</td>
        </tr>';
}

$html = '
<table cellpadding="1">' . $html . '</table>';

$pdf->writeHTMLCell(0, 0, '', '', $html, 0, 1, 0, true, '', true);

// ---------------------------------------------------------

// Close and output PDF document
// This method has several options, check the source code documentation for more information.
// 下載 PDF 的檔案名稱 (不可取中文名,即使有也會自動省略中文名)
$pdf->Output('mis-employees.pdf', 'I');

使用瀏覽器訪問,即可產生 PDF 報表檔案 (僅第一頁有「列印日期」):

問題排除

中文亂碼

必須設定為亞洲字體 $pdf->SetFont('msungstdlight', '', 20);

參考

在〈PHP 使用 TCPDF 製作並產生 PDF 報表〉中有 8 則留言

  1. 您好,請教一下,照著範例實做一次,不過會出現錯誤
    Notice: Undefined variable: html in C:\xampp\htdocs\test\report-employees.php on line 181
    TCPDF ERROR: Some data has already been output, can't send PDF file
    想請問這可能是哪邊有問題呢?

    • "Undefined variable: html" 這段話表示沒有定義 $html 這個變數,但如依我提供的 code,$html 一定會有定義,您可嘗試從這裡找問題。

      • 感謝回覆,不知道是環境問題是還是BUG,在迴圈上方給定一個$html = ""的初始值之後就正常了,感謝!

        • 這並不是 BUG 哦!真正的原因如下:

          TCPDF 套件不能在中途輸出任何資料,由於您有啟用 PHP 的除錯功能:設定檔 display_errors = On 或程式檔案內有使用 ini_set("display_errors", "On");,所以在未定義變數 (此例為 $html) 就使用,PHP 會先發出警告訊息,所以就造成 TCPDF 套件的 ERROR。

    • 181前 加入 $ html ="";

      因為 他在181 那行是 $html .= "網頁內容";

  2. 想請教 1.如何使整個page 轉成image 2.調整整個page的解析度(page內沒有圖片) 3.條碼是否能轉成圖片或調整條碼的解析度

發表留言