math_cms/config/pdf.php

<?php

return [
    /*
    |--------------------------------------------------------------------------
    | PDF调试设置
    |--------------------------------------------------------------------------
    |
    | 启用此选项会在生成PDF时保存HTML副本到storage/app目录
    | 用于调试PDF渲染问题
    |
    */
    'debug_save_html' => env('PDF_DEBUG_SAVE_HTML', false),

    /*
    |--------------------------------------------------------------------------
    | PDF渲染后端
    |--------------------------------------------------------------------------
    |
    | gotenberg：通过常驻 Gotenberg 服务生成 PDF，减少每次启动 Chrome 的长尾耗时。
    | chrome：保留原有本机 Chrome CLI 渲染路径，作为兼容/兜底方案。
    |
    */
    'renderer' => env('PDF_RENDERER', 'gotenberg'),

    /*
    |--------------------------------------------------------------------------
    | Gotenberg 服务配置
    |--------------------------------------------------------------------------
    |
    | PDF worker 通过内网访问 Gotenberg 服务；超时控制单次转换最长等待时间。
    |
    */
    'gotenberg_url' => env('GOTENBERG_URL', 'http://gotenberg:3000'),
    'gotenberg_connect_timeout_seconds' => (int) env('PDF_GOTENBERG_CONNECT_TIMEOUT_SECONDS', 3),
    'gotenberg_timeout_seconds' => (int) env('PDF_GOTENBERG_TIMEOUT_SECONDS', 60),
    'fallback_to_chrome' => env('PDF_FALLBACK_TO_CHROME', true),
    'kp_explain_fetch_timeout_seconds' => (int) env('PDF_KP_EXPLAIN_FETCH_TIMEOUT_SECONDS', 2),

    /*
    |--------------------------------------------------------------------------
    | Chrome 轮询超时（秒）
    |--------------------------------------------------------------------------
    |
    | 主渲染通道等待 PDF 文件落地的最长时长；超时后会快速进入最小参数兜底。
    | 默认 40 秒（旧逻辑固定 80 秒），用于降低异常场景下的长时间卡顿。
    |
    */
    'chrome_poll_timeout_seconds' => (int) env('PDF_CHROME_POLL_TIMEOUT_SECONDS', 40),

    /*
    |--------------------------------------------------------------------------
    | 远程图片尺寸探测超时（秒）
    |--------------------------------------------------------------------------
    |
    | 扁图自适应会探测远程图片宽高。为防止慢图源拖慢 PDF，探测使用短超时。
    |
    */
    'image_probe_timeout_seconds' => (int) env('PDF_IMAGE_PROBE_TIMEOUT_SECONDS', 2),
];