這兩天項目中需要將HTML頁面轉換為PDF文件方便打印，我在網上搜了很多資料。先後嘗試了laravel-dompdf和laravel-snappy兩種擴展包，個人感覺laravel-snappy比較好用。

一、使用laravel-dompdf擴展包

1、安裝擴展包

我們通過composer來安裝

composer require barryvdh/laravel-dompdf

2、將ServiceProvider添加到config / app.php中的providers數組中

Barryvdh\DomPDF\ServiceProvider::class,

3、添加facade到config / app.php中的aliases數組中

‘PDF‘ => Barryvdh\DomPDF\Facade::class,

4、使用

可以創建一個dompdf實例並加載HTML字符串、文件或者視圖，然後使用stream()方法顯示在瀏覽器中、save()方法保存到文件或者download()方法下載。

$pdf = App::make(‘dompdf.wrapper‘);
$pdf->loadHTML(‘<h1>Test</h1>‘);
return $pdf->stream();

也可以使用門面（facade），使用前先use PDF;

$pdf = PDF::loadView(‘pdf.invoice‘, $data
 
);
return $pdf->download(‘invoice.pdf‘);

也可以鏈式操作

return PDF::loadFile(public_path().‘/myfile.html‘)->save(‘/path-to/my_stored_file.pdf‘)->stream(‘download.pdf‘);

可以更改方向（landscape將方向設為橫向，一般使用的都是豎向的，使用時註意一下）和紙張大小，並隱藏或顯示錯誤（默認情況下，調試打開時顯示錯誤）

PDF::loadHTML($html)->setPaper(‘a4‘, ‘landscape‘)->setWarnings(false
 
)->save(‘myfile.pdf‘)

其他的一些基本使用和配置請參考文檔資料https://github.com/barryvdh/laravel-dompdf

5、解決中文亂碼問題

下載一個支持unicode編碼的中文字體。例如：msyh.ttf（微軟雅黑）

建議先在storage下創建fonts文件夾，把字體放在fonts文件夾下，不然會報錯。

在css中引入字體

<style>
            @font-face {
                font-family: ‘msyh‘;
                font-style: normal;
                font-weight: normal;
                src: url({{ storage_path(‘your_path/msyh.ttf‘) }}) format(‘truetype‘);
            }
            body {
                font-family: msyh, DejaVu Sans,sans-serif;
            }
</style>

註意：親測只有unicode編碼的中文，才能正常顯示，這也是我覺得這個PDF擴展不太好用的原因。

二、使用laravel-snappy擴展包

1、安裝依賴軟件

laravel-snappy擴展包需要Wkhtmltopdff的支持，所以先安裝Wkhtmltopdf

方法一：下載wkhtmltopdf安裝包

wkhtmltopdf下載地址http://www.softpedia.com/get/Office-tools/PDF/wkhtmltopdf.shtml

windows直接下載安裝就可以了，註意安裝到你知道的地方，這個路徑後面有用。

我的安裝在G:wk目錄下

在bin目錄下有wkhtmltoimage與wkhtmltopdf兩個依賴軟件

linux下載解壓完成後，要將文件移動到 /usr/local/bin 下

方法二：通過 composer 來安裝

以linux系統為例

32位:
$ composer require h4cc / wkhtmltopdf-i386 0.12.x
$ composer require h4cc / wkhtmltoimage-i386 0.12.x，
64位:
$ composer require h4cc/wkhtmltopdf-amd64 0.12.x
$ composer require h4cc/wkhtmltoimage-amd64 0.12.x

(uname -a 命令查看系統位數)

cp vendor/h4cc/wkhtmltoimage-amd64/bin/wkhtmltoimage-amd64 /usr/local/bin/
cp vendor/h4cc/wkhtmltopdf-amd64/bin/wkhtmltopdf-amd64 /usr/local/bin/
並使其可執行：
chmod +x /usr/local/bin/wkhtmltoimage-amd64 
chmod +x /usr/local/bin/wkhtmltopdf-amd64

Linux 下使用該第三方插件需要幾個庫的支持

apt-get install libXrender*
apt-get install libfontconfig*

1、安裝laravel-snappy擴展包

composer require barryvdh/laravel-snappy

2、將ServiceProvider添加到config / app.php中的providers數組

Barryvdh\Snappy\ServiceProvider::class,

3、添加facade到config / app.php中的aliases數組中

‘PDF‘ => Barryvdh\Snappy\Facades\SnappyPdf::class,
‘SnappyImage‘ => Barryvdh\Snappy\Facades\SnappyImage::class,

4、生成配置文件

php artisan vendor:publish --provider="Barryvdh\Snappy\ServiceProvider"

此命令會在config/snappy.php生成配置文件

具體配置如下:

<?php

return array(


    ‘pdf‘ => array(
        ‘enabled‘ => true,
//        ‘binary‘  => ‘/usr/local/bin/wkhtmltopdf‘,　　　　　//依賴軟件的路徑，linux默認在此目錄下
        ‘binary‘  => ‘G:\wk\wkhtmltopdf\bin\wkhtmltopdf‘,
        ‘timeout‘ => false,
        ‘options‘ => array(),
        ‘env‘     => array(),
    ),
    ‘image‘ => array(
        ‘enabled‘ => true,
//        ‘binary‘  => ‘/usr/local/bin/wkhtmltoimage‘,
        ‘binary‘  => ‘G:\wk\wkhtmltopdf\bin\wkhtmltoimage‘,
        ‘timeout‘ => false,
        ‘options‘ => array(),
        ‘env‘     => array(),
    ),


);

5、使用 ( 與使用dompdf類似 )

先引入

use PDF;
use SnappyImage;

生成PDF文件

可以使用門面（facade）加載HTML字符串、文件或者視圖，然後使用stream()方法顯示在瀏覽器中、save()方法保存到文件或者download()方法下載。

$pdf = PDF::loadView(‘pdf.invoice‘, $data);
return $pdf->download(‘invoice.pdf‘);

也可以鏈式操作

return PDF::loadFile(public_path().‘/myfile.html‘)->save(‘/path-to/my_stored_file.pdf‘)->stream(‘download.pdf‘);

可以更改方向（landscape將方向設為橫向，一般使用的都是豎向的，使用時註意一下）和紙張大小，並隱藏或顯示錯誤（默認情況下，調試打開時顯示錯誤）

PDF::loadHTML($html)->setPaper(‘a4‘, ‘landscape‘)->setWarnings(false)->save(‘myfile.pdf‘)

生成圖片

$pdf = SnappyImage::loadView(‘pdf.invoice‘, $data);
return $pdf->download(‘invoice.image‘);

6、解決中英文亂碼問題 （linux）

可以將例如：宋體或其他中文字體添加到 /usr/share/fonts/ 裏

非常開心能夠將我的學習心得分享給大家 (?>?<?）

laravel中使用的PDF擴展包——laravel-dompdf和laravel-snappy