WordPress环境下HTML表单+PHPMailer+PDF邮件功能故障求助

针对HTTP 500错误的处理 #

• 启用WordPress调试模式：打开wp-config.php，修改以下配置获取具体错误信息：

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

  错误日志会保存在wp-content/debug.log，可根据日志定位问题（比如fPDF路径错误、函数冲突、权限不足等）。
• 修正文件路径：本地环境的绝对路径在WP服务器上无效，引用fPDF等文件时，使用WordPress内置的ABSPATH常量构建路径，例如：

  require_once ABSPATH . 'wp-content/themes/your-theme/fpdf/fpdf.php';
  

• 检查文件权限：确保表单处理PHP文件权限设为644，所在文件夹权限设为755，避免服务器拒绝执行。
• 集成到WordPress生态：不要直接上传独立PHP文件处理表单，改为自定义短代码或自定义插件，利用WP的钩子（如init）处理表单提交，避免触发WP的安全机制。

针对403 Forbidden错误的处理 #

• 禁止修改核心文件夹：wp-includes是WordPress核心目录，Nginx服务器通常有安全规则拦截该目录下的自定义文件操作，绝对不要将PHPMailer或自定义代码放入此处。
• 正确存放自定义文件：将fPDF、表单处理代码放在以下位置：
  • 主题子文件夹：wp-content/themes/your-theme/custom-form/
  • 自定义插件：wp-content/plugins/your-form-plugin/

通用优化建议 #

• 使用WP内置wp_mail()函数：WordPress已集成PHPMailer，直接调用该函数发送邮件，无需手动引入PHPMailer，避免版本冲突。添加PDF附件示例：

  // 生成PDF到WP上传目录
  $upload_dir = wp_upload_dir();
  $pdf_file = $upload_dir['path'] . '/form-submission.pdf';
  // 此处执行fPDF生成逻辑，保存到$pdf_file
  
  // 发送邮件
  $to = 'recipient@example.com';
  $subject = '表单提交邮件';
  $message = '<p>这是表单提交的HTML内容</p>';
  $headers = array('Content-Type: text/html; charset=UTF-8');
  $attachments = array($pdf_file);
  
  wp_mail($to, $subject, $message, $headers, $attachments);
  

• 添加安全验证：在表单中加入WPnonce字段，防止CSRF攻击，提交后用wp_verify_nonce()验证；同时用sanitize_text_field()等函数过滤用户输入。
• 清理临时文件：生成的PDF附件在发送后，记得删除临时文件，避免占用服务器空间：

  if (file_exists($pdf_file)) {
      unlink($pdf_file);
  }
  

内容的提问来源于stack exchange，提问作者Csaba Budai