首页 > 文章 > php教程

Dompdf生成PDF的高效优化技巧

时间：2025-10-31 14:42:37 432浏览收藏

本篇文章向大家介绍《使用Dompdf高效生成大量PDF的优化方法》，主要包括，具有一定的参考价值，需要的朋友可以参考一下。

使用 Dompdf 一键生成大量 PDF 文件的优化方案

本文旨在解决使用 Dompdf 生成大量 PDF 文件时遇到的超时问题。通过分析常见原因，提出了从Web服务器环境迁移到命令行环境，并配合 set_time_limit(0) 函数来避免执行超时，从而高效生成多个包含大量数据的 PDF 文件。

问题分析

从提供的代码片段可以看出，程序通过循环遍历 $finalItems 数组，针对每个 item 从数据库中获取销售、采购和库存转移数据，然后使用 Dompdf 将这些数据渲染成 PDF 文件。当某个 item 对应的数据量非常大（例如 2000+ 行）时，生成 PDF 的过程会耗费大量时间，导致 Web 服务器超时。

解决方案：迁移到命令行环境

生成大量 PDF 文件并非 Web 服务器的理想任务。Web 服务器主要用于处理 HTTP 请求，而长时间运行的 PDF 生成任务会占用服务器资源，影响其他用户的访问。因此，建议将 PDF 生成任务迁移到命令行环境执行。

1. 编写命令行脚本

创建一个 PHP 脚本，例如 generate_pdfs.php，用于执行 PDF 生成任务。

setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
    echo "Connection failed: " . $e->getMessage();
    exit;
}

// 假设 $finalItems 来自于外部输入，例如文件或数据库
// 这里为了演示，直接定义一个示例数组
$finalItems = ['item1', 'item2', 'item3']; // 替换为你的实际数据

// 循环处理每个 item
foreach ($finalItems as $item) {
    echo "Generating PDF for item: " . $item . "\n";

    // 从数据库获取数据
    $stmt = $pdo->prepare("SELECT `group` FROM item_master WHERE item_name = ?");
    $stmt->execute([$item]);
    $getGrp = $stmt->fetch(PDO::FETCH_ASSOC);

    $site_id = 1; // 替换为你的实际 site_id
    $fromDate = '2023-01-01'; // 替换为你的实际 fromDate
    $toDate = '2023-12-31'; // 替换为你的实际 toDate

    $stmt = $pdo->prepare("SELECT * FROM sale_data WHERE item_name = ? AND site_id = ? AND bill_date BETWEEN ? AND ?");
    $stmt->execute([$item, $site_id, $fromDate, $toDate]);
    $saleData = $stmt->fetchAll(PDO::FETCH_ASSOC);

    $stmt = $pdo->prepare("SELECT * FROM purchase_data WHERE item_name = ? AND site_id = ? AND bill_date BETWEEN ? AND ?");
    $stmt->execute([$item, $site_id, $fromDate, $toDate]);
    $purchaseData = $stmt->fetchAll(PDO::FETCH_ASSOC);

    $stmt = $pdo->prepare("SELECT * FROM stock_transfer WHERE item_name = ? AND site_id = ? AND bill_date BETWEEN ? AND ?");
    $stmt->execute([$item, $site_id, $fromDate, $toDate]);
    $stock_trf = $stmt->fetchAll(PDO::FETCH_ASSOC);

    $res = array_merge($saleData, $purchaseData, $stock_trf);

    $groupName = $getGrp['group'];

    // 初始化 Dompdf
    $options = new Options();
    $options->set('defaultFont', 'Arial');
    $dompdf = new Dompdf($options);

    // 加载 HTML 视图
    // 注意：这里需要根据你的实际情况修改 HTML 视图的路径
    ob_start();
    include('myPDF.php'); // 包含你的 HTML 视图文件
    $html = ob_get_clean();
    $dompdf->loadHtml($html);

    // 设置纸张大小和方向
    $dompdf->setPaper('a3', 'landscape');

    // 渲染 PDF
    $dompdf->render();

    // 保存 PDF 文件
    $pdf_filename = 'item_' . $item . '.pdf';
    $pdf_path = 'pdf/' . $pdf_filename; // 替换为你想要的保存路径
    file_put_contents($pdf_path, $dompdf->output());

    echo "PDF saved to: " . $pdf_path . "\n";
}

echo "All PDFs generated successfully!\n";

?>

2. 修改 HTML 视图文件 (myPDF.php)

将原有的 Blade 模板代码转换为纯 PHP 代码。




    Item Data
    


    
        
            
                Batch No
                Mfg Date
                Exp Date
                Last Balance
                Quantity
                New Balance
                Bill No
                Bill Date
                Customer Name

3. 执行命令行脚本

在命令行中运行以下命令：

php generate_pdfs.php

4. 传递参数

如果需要从 Web 页面传递参数给命令行脚本，可以使用以下方法：

将参数写入文件： Web 页面将 $finalItems 等参数写入一个文件，命令行脚本读取该文件。
使用数据库： Web 页面将参数存储到数据库，命令行脚本从数据库读取参数。

注意事项：

确保 PHP CLI 已安装并配置正确。
确保 Dompdf 及其依赖项已正确安装。
根据实际情况修改数据库连接信息、文件路径和 HTML 视图。
set_time_limit(0) 必须放在脚本的最前面，确保在执行任何可能超时的操作之前生效。
在命令行环境下，需要手动处理错误和异常，例如使用 try...catch 块。
对于需要大量内存的任务，可能需要调整 PHP 的 memory_limit 配置。

总结

通过将 PDF 生成任务迁移到命令行环境，并使用 set_time_limit(0) 函数，可以有效地避免 Web 服务器超时问题，从而高效地生成大量 PDF 文件。同时，使用命令行脚本可以更好地控制任务的执行过程，并方便进行错误处理和日志记录。

今天关于《Dompdf生成PDF的高效优化技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！