使用WordPress save_post_products钩子生成文件失败，求解决方案

1. 先确认钩子是否真的触发 #

前端开发者常忽略WP钩子的触发验证，先加日志确认：

function generate_product_pdf($post_id) {
    // 写入调试日志到wp-content/debug.log
    error_log('save_post_products钩子已触发，当前文章ID：' . $post_id);
    // 后续生成代码...
}
add_action('save_post_products', 'generate_product_pdf', 10, 1);

先在wp-config.php开启调试：

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

保存文章后去wp-content/debug.log看有没有日志。如果没有，大概率是自定义文章类型的slug写错了（比如实际是product而非products，钩子名要对应改成save_post_product）。

2. 排查权限与路径问题 #

本地环境的权限和路径是高频坑：

• 用绝对路径测试文件写入，别用相对路径：

  $test_file = plugin_dir_path(__FILE__) . 'test_write.txt';
  // 先确保父目录存在
  if (!file_exists(dirname($test_file))) {
      mkdir(dirname($test_file), 0755, true);
  }
  $write_result = file_put_contents($test_file, '测试内容');
  error_log('文件写入结果：' . var_export($write_result, true));
  

  去插件目录看有没有生成test_write.txt，如果没生成：
  • 右键插件目录，把权限改成755，文件权限设为644；
  • 本地WAMP/XAMPP环境的话，给Apache/Nginx的运行用户（比如www-data、apache）添加目录读写权限。

3. 过滤无效的钩子触发场景 #

WP的save_post系列钩子会在自动保存、修订版保存时触发，这些场景下可能因环境限制导致生成失败：

function generate_product_pdf($post_id) {
    // 跳过自动保存
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;
    // 跳过修订版
    if (wp_is_post_revision($post_id)) return;
    // 只处理已发布的products类型文章
    if (get_post_type($post_id) !== 'products' || get_post_status($post_id) !== 'publish') return;

    // 你的PDF生成代码...
}
add_action('save_post_products', 'generate_product_pdf', 10, 1);

4. 捕获DOMPDF的错误信息 #

即使钩子外正常，钩子环境下可能存在依赖缺失，用异常捕获排查：

try {
    // 你的DOMPDF初始化与渲染代码
    $dompdf = new Dompdf\Dompdf();
    $dompdf->loadHtml('PDF内容');
    $dompdf->render();
    $pdf_output = $dompdf->output();

    $pdf_path = plugin_dir_path(__FILE__) . 'products_pdf/' . $post_id . '.pdf';
    if (!file_exists(dirname($pdf_path))) {
        mkdir(dirname($pdf_path), 0755, true);
    }
    file_put_contents($pdf_path, $pdf_output);
    error_log('PDF生成成功，路径：' . $pdf_path);
} catch (Exception $e) {
    error_log('DOMPDF生成错误：' . $e->getMessage());
}

查看debug.log里的错误信息，比如是否缺少PHP扩展（如mbstring、gd），或者内存不足。

5. 调整PHP环境配置 #

生成PDF可能需要更高内存，且依赖allow_url_fopen加载资源：

• 在wp-config.php里增加内存限制：

  define('WP_MEMORY_LIMIT', '256M');
  

• 查看phpinfo()确认allow_url_fopen是否为On，如果是Off，在php.ini里开启。

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