Laravel部署Linux后dompdf无法加载本地背景图片求助

问题场景 #

在Windows本地开发Laravel应用时，使用barryvdh/laravel-dompdf生成带背景图的PDF正常显示，但部署到Linux服务器后，本地服务器的背景图无法加载，仅能显示外部图片。相关代码如下：

PDF生成代码 #

$pdf = PDF::setOptions(
['defaultFont' => 'sans-serif', 'isHtml5ParserEnabled' => true, 'isRemoteEnabled' => true]) -> 
loadView('admin.pdf.report', compact('report', 'title', 'reportcontent'));
$pdf->render();
return $pdf->download('Report'.'.pdf');

视图背景图样式 #

#background {
    background-image: url('{{ asset('logo\logo.png') }}');         
    background-position: center;
    background-repeat: no-repeat;
    background-size: 500px 500px;
}

问题原因及解决方法 #

这个问题主要和路径分隔符差异、Linux文件权限以及dompdf的资源加载逻辑有关，以下是具体解决步骤：

• 修正路径分隔符：Windows使用反斜杠\作为路径分隔符，但URL和Linux系统统一使用正斜杠/。将asset中的路径改为logo/logo.png，因为asset()生成的是Web访问路径，而非本地文件路径，正确写法：

  background-image: url('{{ asset('logo/logo.png') }}');
  

• 使用本地绝对路径加载：如果Web访问路径仍无法被dompdf解析，可直接传入服务器本地绝对路径，利用Laravel的public_path()函数获取：

  background-image: url('{{ public_path('logo/logo.png') }}');
  

  注意：确保dompdf有权限读取该路径下的文件。

• 检查Linux文件权限：Linux下Web服务器运行用户（如www-data）需要拥有读取public/logo目录及文件的权限，执行以下命令调整：

  chmod -R 755 public/logo
  chown -R www-data:www-data public/logo
  

  根据你的服务器运行用户调整命令中的用户组。

• 嵌入Base64格式图片（终极方案）：彻底规避路径和权限问题，将图片转换为Base64编码嵌入CSS：

  1. 在控制器中生成Base64编码：

     $base64Image = base64_encode(file_get_contents(public_path('logo/logo.png')));
     

  2. 传递到视图后在CSS中使用：

     #background {
         background-image: url('data:image/png;base64,{{ $base64Image }}');         
         /* 其他样式保持不变 */
     }
     

内容的提问来源于stack exchange，提问作者ITgirl