barryvdh/laravel-dompdf 包

将 HTML 转成 PDF 的包

安装

composer require barryvdh/laravel-dompdf

发布配置

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

config/app.confprovidersaliases 配置根据你的 laravel 版本看

providers 中
Barryvdh\DomPDF\ServiceProvider::class,

aliases 中
'PDF' => Barryvdh\DomPDF\Facade::class,

测试

写一个测试脚本,简单逻辑如下:

    public function test200($params)
    {
        $url = $params[1];

        if (empty($url)) {
            return ['code' => 10001, 'msg' => '链接地址不能为空', 'url' => ''];
        }

        if (empty($filename)) {
            $filename = uniqid() . date('YmdHis');
        }

        $filename = $filename . '.pdf';

        $div = "/pdf/prediction/";
        if (!Storage::disk('public')->exists("/{$div}")) {
            Storage::disk('public')->makeDirectory("/{$div}");
        }

        $config = ['path' => Storage::disk('public')->path($div)];
        // $html   = file_get_contents($url);

        $html = <<<html
<style>
    body{
        font-family:"STSONG";
    }
</style>
<h3>pdf 下载</h3>
<table>
    <tr>
        <td>数学</td>
        <td>物理</td>
        <td>English</td>
        <td>主要测试中文</td>
    </tr>
    <tr>
        <td>数学</td>
        <td>物理</td>
        <td>English</td>
        <td>主要测试中文</td>
    </tr>
    <tr>
        <td>数学</td>
        <td>物理</td>
        <td>English</td>
        <td>主要测试中文</td>
    </tr>
</table>
html;

        Pdf::loadHTML($html)
            ->setPaper('a4', 'landscape')
            ->setWarnings(false)
            ->save($config['path'] . $filename);

        $data = ['code' => 1, 'msg' => 'PDF已生成', 'url' => $config['path'] . $filename];
        dd($data);
    }

运行脚本 php artisan test 200 xxx

找到生成的相应的PDF路径,打开PDF查看,发现中文乱码

解决中文乱码

下载字体文件

下载一个中文字体包,ttf 格式的,可以直接在系统字体文件夹中复制一个中文字体,比如华文宋体,将字体放在项目根目录下,和 .env 文件同级

下载字体转换代码

下载字体转换代码,GitHub地址: https://github.com/dompdf/utils/ 下载那个 load_font.php 即可,将下载的文件放根目录

执行代码 php load_font.php stsong STSONG.TTF

执行成功后,字体安装位置在 vendor/dompdf/dompdf/lib/fonts/ 下,会生成 installed-fonts.jsonSTSONG.TTFSTSONG.ufm

将转换好的字体放在合适的地方

因为是放在 vendor 下,对实际项目中可能不便,所以要将该字体和配置文件提取出来,在 storage 文件夹中新建一个文件夹 fonts ,将 installed-fonts.jsonSTSONG.TTFSTSONG.ufm 放在 fonts 文件夹中

修改转换好的json文件

打开 installed-fonts.json 文件,发现里面是引用的绝对路径,修改成字体文件的文件名

{
    "stsong": {
        "normal": "STSONG"
    }
}

config/dompdf.php 配置

"font_dir" => storage_path('fonts'),
"font_cache" => storage_path('fonts'),

配置完成后,再次执行脚本 php artisan test 200 xxx

PDF 过大

config/dompdf.php 中的 enable_font_subsetting字段设置为 true

load_font.php 文件内容如下:

<?php
// 1. [Required] Point to the composer or dompdf autoloader
require_once "vendor/autoload.php";

// 2. [Optional] Set the path to your font directory
//    By default dompdf loads fonts to dompdf/lib/fonts
//    If you have modified your font directory set this
//    variable appropriately.
//$fontDir = "lib/fonts";


// *** DO NOT MODIFY BELOW THIS POINT ***

use Dompdf\Dompdf;
use Dompdf\CanvasFactory;
use Dompdf\Exception;
use Dompdf\FontMetrics;
use Dompdf\Options;

use FontLib\Font;

/**
 * Display command line usage
 */
function usage() {
  echo <<<EOD

Usage: {$_SERVER["argv"][0]} font_family [n_file [b_file] [i_file] [bi_file]]

font_family:      the name of the font, e.g. Verdana, 'Times New Roman',
                  monospace, sans-serif. If it equals to "system_fonts", 
                  all the system fonts will be installed.

n_file:           the .ttf or .otf file for the normal, non-bold, non-italic
                  face of the font.

{b|i|bi}_file:    the files for each of the respective (bold, italic,
                  bold-italic) faces.

If the optional b|i|bi files are not specified, load_font.php will search
the directory containing normal font file (n_file) for additional files that
it thinks might be the correct ones (e.g. that end in _Bold or b or B).  If
it finds the files they will also be processed.  All files will be
automatically copied to the DOMPDF font directory, and afm files will be
generated using php-font-lib (https://github.com/PhenX/php-font-lib).

Examples:

./load_font.php silkscreen /usr/share/fonts/truetype/slkscr.ttf
./load_font.php 'Times New Roman' /mnt/c_drive/WINDOWS/Fonts/times.ttf

EOD;
exit;
}

if ( $_SERVER["argc"] < 3 && @$_SERVER["argv"][1] != "system_fonts" ) {
  usage();
}

$dompdf = new Dompdf();
if (isset($fontDir) && realpath($fontDir) !== false) {
  $dompdf->getOptions()->set('fontDir', $fontDir);
}

/**
 * Installs a new font family
 * This function maps a font-family name to a font.  It tries to locate the
 * bold, italic, and bold italic versions of the font as well.  Once the
 * files are located, ttf versions of the font are copied to the fonts
 * directory.  Changes to the font lookup table are saved to the cache.
 *
 * @param Dompdf $dompdf      dompdf main object 
 * @param string $fontname    the font-family name
 * @param string $normal      the filename of the normal face font subtype
 * @param string $bold        the filename of the bold face font subtype
 * @param string $italic      the filename of the italic face font subtype
 * @param string $bold_italic the filename of the bold italic face font subtype
 *
 * @throws Exception
 */
function install_font_family($dompdf, $fontname, $normal, $bold = null, $italic = null, $bold_italic = null) {
  $fontMetrics = $dompdf->getFontMetrics();
  
  // Check if the base filename is readable
  if ( !is_readable($normal) )
    throw new Exception("Unable to read '$normal'.");

  $dir = dirname($normal);
  $basename = basename($normal);
  $last_dot = strrpos($basename, '.');
  if ($last_dot !== false) {
    $file = substr($basename, 0, $last_dot);
    $ext = strtolower(substr($basename, $last_dot));
  } else {
    $file = $basename;
    $ext = '';
  }

  if ( !in_array($ext, array(".ttf", ".otf")) ) {
    throw new Exception("Unable to process fonts of type '$ext'.");
  }

  // Try $file_Bold.$ext etc.
  $path = "$dir/$file";
  
  $patterns = array(
    "bold"        => array("_Bold", "b", "B", "bd", "BD"),
    "italic"      => array("_Italic", "i", "I"),
    "bold_italic" => array("_Bold_Italic", "bi", "BI", "ib", "IB"),
  );
  
  foreach ($patterns as $type => $_patterns) {
    if ( !isset($$type) || !is_readable($$type) ) {
      foreach($_patterns as $_pattern) {
        if ( is_readable("$path$_pattern$ext") ) {
          $$type = "$path$_pattern$ext";
          break;
        }
      }
      
      if ( is_null($$type) )
        echo ("Unable to find $type face file.\n");
    }
  }

  $fonts = compact("normal", "bold", "italic", "bold_italic");
  $entry = array();

  // Copy the files to the font directory.
  foreach ($fonts as $var => $src) {
    if ( is_null($src) ) {
      $entry[$var] = $dompdf->getOptions()->get('fontDir') . '/' . mb_substr(basename($normal), 0, -4);
      continue;
    }

    // Verify that the fonts exist and are readable
    if ( !is_readable($src) )
      throw new Exception("Requested font '$src' is not readable");

    $dest = $dompdf->getOptions()->get('fontDir') . '/' . basename($src);

    if ( !is_writeable(dirname($dest)) )
      throw new Exception("Unable to write to destination '$dest'.");

    echo "Copying $src to $dest...\n";

    if ( !copy($src, $dest) )
      throw new Exception("Unable to copy '$src' to '$dest'");
    
    $entry_name = mb_substr($dest, 0, -4);
    
    echo "Generating Adobe Font Metrics for $entry_name...\n";
    
    $font_obj = Font::load($dest);
    $font_obj->saveAdobeFontMetrics("$entry_name.ufm");
    $font_obj->close();

    $entry[$var] = $entry_name;
  }

  // Store the fonts in the lookup table
  $fontMetrics->setFontFamily($fontname, $entry);

  // Save the changes
  $fontMetrics->saveFontFamilies();
}

// If installing system fonts (may take a long time)
if ( $_SERVER["argv"][1] === "system_fonts" ) {
  $fontMetrics = $dompdf->getFontMetrics();
  $files = glob("/usr/share/fonts/truetype/*.ttf") +
    glob("/usr/share/fonts/truetype/*/*.ttf") +
    glob("/usr/share/fonts/truetype/*/*/*.ttf") +
    glob("C:\\Windows\\fonts\\*.ttf") +
    glob("C:\\WinNT\\fonts\\*.ttf") +
    glob("/mnt/c_drive/WINDOWS/Fonts/");
  $fonts = array();
  foreach ($files as $file) {
      $font = Font::load($file);
      $records = $font->getData("name", "records");
      $type = $fontMetrics->getType($records[2]);
      $fonts[mb_strtolower($records[1])][$type] = $file;
      $font->close();
  }
  
  foreach ( $fonts as $family => $files ) {
    echo " >> Installing '$family'... \n";
    
    if ( !isset($files["normal"]) ) {
      echo "No 'normal' style font file\n";
    }
    else {
      install_font_family($dompdf, $family, @$files["normal"], @$files["bold"], @$files["italic"], @$files["bold_italic"]);
      echo "Done !\n";
    }
    
    echo "\n";
  }
}
else {
  call_user_func_array("install_font_family", array_merge( array($dompdf), array_slice($_SERVER["argv"], 1) ));
}