最近在开发一个 laravel 项目，需要生成包含中文内容的 PDF 报表。然而，直接使用 TCPDF 生成的 PDF 文件却出现了中文乱码的问题，严重影响了用户体验。为了解决这个问题，我尝试了各种方法，例如修改字体、设置编码等等，但效果都不理想。后来，我发现了 elibyy/tcpdf-laravel 这个扩展包，它简化了 TCPDF 的集成，并且提供了一些方便的配置选项，最终解决了我的问题。
elibyy/tcpdf-laravel 是一个 Laravel 的服务提供者，它封装了 TCPDF 库，让你可以在 Laravel 项目中更方便地使用 TCPDF 生成 PDF 文件。它支持 Laravel 6、7、8、9、10 和 11 等多个版本。
安装
使用 composer 安装非常简单：
composer require elibyy/tcpdf-laravel
Laravel 5.5+ 支持自动发现，所以安装完成后，通常不需要手动注册服务提供者和 Facade。如果你的 Laravel 版本低于 5.5，或者禁用了自动发现，则需要在 config/app.php 中手动注册：
'providers' => [ //... ElibyyTCPDFServiceProvider::class, ], 'aliases' => [ //... 'PDF' => ElibyyTCPDFFacadesTCPDF::class ]
使用
安装完成后，你就可以在你的代码中使用 PDF Facade 来调用 TCPDF 的方法了。例如：
use PDF; PDF::SetTitle('你好，世界'); PDF::AddPage(); PDF::Write(0, '你好，世界'); PDF::Output('hello_world.pdf');
配置
elibyy/tcpdf-laravel 提供了一些基本的配置选项，你可以通过发布配置文件来修改默认配置：
php artisan vendor:publish --provider="ElibyyTCPDFServiceProvider"
发布后，你可以在 config/tcpdf.php 文件中修改配置。其中一些常用的配置选项包括：
- use_original_header：是否使用 TCPDF 原始的 Header 方法。
- use_original_footer：是否使用 TCPDF 原始的 Footer 方法。
- font_directory：字体目录。你可以在这里指定包含中文支持的字体文件。
解决中文乱码
要解决中文乱码问题，你需要确保使用支持中文的字体，并在代码中设置正确的字体。例如：
use PDF; PDF::SetFont('simhei', '', 14); // 设置字体为 simhei，大小为 14 PDF::SetTitle('你好，世界'); PDF::AddPage(); PDF::Write(0, '你好，世界'); PDF::Output('hello_world.pdf');
其中，simhei 是一种常用的中文黑体字体。你需要将 simhei.ttf 字体文件复制到 config/tcpdf.php 文件中 font_directory 配置项指定的目录下。
总结
elibyy/tcpdf-laravel 简化了 TCPDF 在 Laravel 项目中的集成，并提供了一些便捷的配置选项，可以帮助你轻松解决中文乱码等问题。如果你需要在 Laravel 项目中生成包含中文内容的 PDF 文件，那么 elibyy/tcpdf-laravel 是一个非常不错的选择。它让你能够专注于业务逻辑的开发，而无需花费大量时间在 TCPDF 的配置上。
