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

標籤：wrapper   cape   微軟雅黑   font   bsp   alt   cap   win   添加   

這兩天項目中需要將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安裝包

wkhtmltopdfhttp://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組建組態檔案

具體配置如下:

<?phpreturn 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