Laravel Backpack v5中DataTables PDF导出HTML实体编码异常问题

问题原因 #

使用$this->crud->enableExportButtons()开启导出功能时，PDF导出会默认保留字段的HTML转义结果（比如&被转成&），而添加->escape(true)会进一步强化转义，反而加剧问题。

解决方案 #

方案1：针对单个字段设置导出回调 #

在CrudController的setupListOperation方法中，给包含特殊字符的字段添加exportCallback，通过html_entity_decode解析HTML实体：

$this->crud->addColumn([
    'name' => 'your_field_name', // 替换为实际字段名
    'label' => '字段显示名称',
    // 其他字段配置项...
    'exportCallback' => function($value) {
        // 解析HTML实体，还原原始特殊字符
        return html_entity_decode($value, ENT_QUOTES, 'UTF-8');
    }
]);

方案2：自定义导出类批量处理所有字段 #

如果多个字段存在相同问题，可创建自定义导出类统一处理：

1. 创建自定义导出文件：

// app/Exports/CustomPdfExport.php
namespace App\Exports;

use Backpack\CRUD\app\Library\CrudPanel\CrudPanel;
use Backpack\CRUD\app\Exports\DefaultExport;

class CustomPdfExport extends DefaultExport
{
    public function __construct(CrudPanel $crudPanel)
    {
        parent::__construct($crudPanel);
    }

    public function map($row): array
    {
        $mappedRow = parent::map($row);
        
        // 遍历所有字段，批量解析HTML实体
        foreach ($mappedRow as $key => $value) {
            if (is_string($value)) {
                $mappedRow[$key] = html_entity_decode($value, ENT_QUOTES, 'UTF-8');
            }
        }
        
        return $mappedRow;
    }
}

2. 在CrudController中注册自定义导出类：

use App\Exports\CustomPdfExport;

// 在setupListOperation方法内
$this->crud->enableExportButtons();
// 替换默认导出类为自定义类
$this->crud->setExportClass(CustomPdfExport::class);

注意事项 #

• 移除字段配置中的->escape(true)，该配置会主动转义特殊字符，导致导出时出现双重转义问题；若列表页面需要正常显示特殊字符，可保留->escape(true)，仅通过exportCallback处理导出场景。

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