math_cms/config/pdf.php

<?php

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

    /*
    |--------------------------------------------------------------------------
    | 统一PDF：是否包含“知识点讲解”章节（默认值）
    |--------------------------------------------------------------------------
    |
    | 当生成统一PDF（卷子+判卷）时，可在最前面插入“知识点讲解”章节。
    | - 该默认值可被请求参数覆盖（例如 include_kp_explain=true/false）
    | - 关闭时保持现有“卷子+判卷”二合一行为不变
    |
    */
    'include_kp_explain_default' => env('PDF_INCLUDE_KP_EXPLAIN', false),
    '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),
];