技術標籤：需要某個字型包才能正確顯示此頁面

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

一、使用laravel-dompdf擴充套件包

1、安裝擴充套件包

我們通過composer來安裝

composer require barryvdh/laravel-dompdf

2、將ServiceProvider新增到config / app.php中的providers陣列中

BarryvdhDomPDFServiceProvider::class,
 

3、新增facade到config / app.php中的aliases陣列中

'PDF' => BarryvdhDomPDFFacade::class,

4、使用

可以建立一個dompdf例項並載入HTML字串、檔案或者檢視，然後使用stream()方法顯示在瀏覽器中、save()方法儲存到檔案或者download()方法下載。

$pdf = App::make('dompdf.wrapper');$pdf->loadHTML('

Test

也可以使用門面(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中引入字型

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

二、使用laravel-snappy擴充套件包

1、安裝依賴軟體

laravel-snappy擴充套件包需要Wkhtmltopdff的支援，所以先安裝Wkhtmltopdf

方法一：下載wkhtmltopdf安裝包

wkhtmltopdf 下載地址：https://wkhtmltopdf.org/downloads.html

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 下使用該第三方外掛需要幾個庫的支援

yum install libXrender*yum install libfontconfig*

2、安裝laravel-snappy擴充套件包

composer require barryvdh/laravel-snappy

3、將ServiceProvider新增到config / app.php中的providers陣列

BarryvdhSnappyServiceProvider::class,

4、新增facade到config / app.php中的aliases陣列中

'PDF' => BarryvdhSnappyFacadesSnappyPdf::class,'SnappyImage' => BarryvdhSnappyFacadesSnappyImage::class,

5、生成配置檔案

高版本的 laravel ，例如 Version 5.5 以上，請忽略上面的3,4步驟，直接到這裡生成皮配置檔案 php artisan vendor:publish --provider="BarryvdhSnappyServiceProvider"

此命令會在 config/snappy.php 生成配置檔案

具體配置如下:

<?php return [     'pdf' => [        'enabled' => true,        'binary'  => env('WKHTML_PDF_BINARY', '/usr/local/bin/wkhtmltopdf-amd64'), // linux 配置路徑        // 'binary'  => env('WKHTML_PDF_BINARY', 'G:wkwkhtmltopdfbinwkhtmltopdfwkhtmltopdf-amd64'), // windows 配置路徑        'timeout' => false,        'options' => [],        'env'     => [],    ],     'image' => [        'enabled' => true,        'binary'  => env('WKHTML_IMG_BINARY', '/usr/local/bin/wkhtmltoimage-amd64'), // linux 配置路徑        // 'binary'  => env('WKHTML_IMG_BINARY', 'G:wkwkhtmltopdfbinwkhtmltopdfwkhtmltoimage-amd64'), // windows 配置路徑        'timeout' => false,        'options' => [],        'env'     => [],    ], ];

6、使用 ( 與使用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');

7、解決中英文亂碼問題 (linux)

方法一：

宋體或其他中文字型新增到 /usr/share/fonts/ 裡

方法二：

安裝中文字型：

yum install ipa-gothic-fonts ipa-mincho-fonts ipa-pgothic-fonts ipa-pmincho-fonts 

在方法裡面轉義為 utf-8

 $pdf -> setOption('encoding', 'utf-8'); 

Demo測試用例如下：

Controller 層

<?php namespace AppHttpControllersV2; use IlluminateHttpRequest;use AppResponsesRes;use IlluminateSupportFacadesValidator;use PDF;use SnappyImage;use App;use IlluminateSupportFacadesResponse; class PdfController extends Controller{     /**     * 您可以建立一個新的Snappy PDF / Image例項並載入HTML字串，檔案或檢視名稱。您可以將其儲存到檔案中，也可以內聯(在瀏覽器中顯示)或下載。     * 使用App容器：     */    public function pdf1()    {        $snappy = App::make('snappy.pdf');        //To file        $html = '

Bill

You owe me money, dude.

Test-中文

11111

Test

份打散加啦

View層(v2.pdf.view_test)：

{{$h1}}

{{$h2}}

{{$h3}}

參考資料如下：

laravel-dompdf包： https://packagist.org/packages/barryvdh/laravel-dompdf

laravel-snappy包：https://packagist.org/packages/barryvdh/laravel-snappy