dompdf是laravel中轻量易用的html转pdf库，需通过laravel-dompdf包集成，配置字体与视图后，用pdf门面生成并流式响应pdf文件。
如果您在Laravel项目中需要将HTML内容转换为PDF并输出，Dompdf是一个轻量且易于集成的PHP PDF生成库。以下是使用Dompdf插件在Laravel中生成并打印PDF文件的具体步骤：
一、安装Dompdf及Laravel适配包
Dompdf本身不直接支持Laravel的视图渲染机制，需借助laravel-dompdf包实现无缝集成。该包封装了Dompdf核心功能，并提供Facade和视图指令支持。
1、在项目根目录执行Composer命令安装laravel-dompdf包：composer require barryvdh/laravel-dompdf。
2、若使用Laravel 5.5及以上版本，包会自动注册服务提供者；如为Laravel 5.4或更早版本，需手动在config/app.php的providers数组中添加：Barryvdh\DomPDF\ServiceProvider::class。
3、同样在config/app.php的aliases数组中添加门面别名：'PDF' => Barryvdh\DomPDF\Facade::class。
二、发布并配置Dompdf设置
发布配置文件可自定义字体路径、纸张尺寸、DPI等参数，确保生成的PDF符合实际打印需求，避免中文乱码或布局错位。
1、运行Artisan命令发布配置：php artisan vendor:publish --provider="Barryvdh\DomPDF\ServiceProvider"。
2、打开config/dompdf.php，确认'default_font'设为'sans-serif'或已加载中文字体（如'simhei'），并检查'chroot'是否指向public_path()以保障资源路径可读。
3、如需支持中文，将TrueType字体文件（如simhei.ttf）放入storage/fonts/目录，并运行php artisan dompdf:install-font simhei完成字体注册。
三、创建PDF专用视图模板
Laravel PDF生成依赖于Blade视图，该视图应仅包含适合打印的静态结构与内联样式，避免外部CSS文件引用，防止Dompdf无法解析路径。
1、在resources/views下新建视图文件，例如pdf/invoice.blade.php。
2、在该文件中使用内联样式控制页面尺寸与边距，例如添加：。
3、视图中可使用Laravel Blade语法动态插入数据，如{{ $order->number }}，但禁止使用JavaScript或未被Dompdf支持的CSS属性（如flexbox、grid）。
四、在控制器中生成PDF响应
通过PDF门面调用loadView()方法加载Blade视图，再使用stream()或download()触发浏览器响应，实现即时预览或强制下载。
1、在控制器方法中引入PDF门面：use PDF;。
2、构建数据并传入视图：$data = ['order' => Order::find($id)];。
3、生成PDF并返回流式响应：return PDF::loadView('pdf.invoice', $data)->stream('invoice.pdf');。
4、若需保存PDF到服务器而非响应浏览器，改用save()方法：PDF::loadView('pdf.invoice', $data)->save(storage_path('app/invoices/invoice_'.$id.'.pdf'));。
五、实现前端一键打印功能
生成PDF后，用户可能需要直接调用系统打印机输出纸质文档。可通过嵌入PDF预览并绑定浏览器原生打印指令实现。
1、在返回PDF流的路由中，不直接跳转，而是返回一个中间页面，内嵌<iframe></iframe>加载PDF URL。
2、在该页面中添加JavaScript按钮，点击时执行：document.querySelector('iframe').contentWindow.print();。
3、确保PDF响应头包含Content-Disposition: inline（stream()默认满足），否则浏览器可能触发下载而非内嵌显示。
