使用Contact Form 7自定义注册页时wp_handle_upload()上传失败

问题分析 #

直接调用$_FILES['file']获取CF7上传文件会出错，因为Contact Form 7的上传文件数据并非直接存于全局$_FILES中，而是封装在表单提交实例里，且默认临时存储在特定目录，需要通过正确方式提取后再处理。

正确实现步骤 #

• 获取CF7提交实例：从钩子参数中拿到当前表单对象，提取提交数据与上传文件信息
• 验证文件有效性：先确认文件字段存在上传内容，避免空值处理报错
• 标准化文件数据：将CF7返回的临时文件路径整理成wp_handle_upload要求的数组格式
• 处理上传并关联用户：完成文件上传后，将返回的文件信息绑定到新注册用户的元数据中

完整代码示例 #

add_action('wpcf7_before_send_mail', function ($contact_form) {
    // 引入WordPress文件处理核心函数
    require_once(ABSPATH . 'wp-admin/includes/file.php');
    require_once(ABSPATH . 'wp-admin/includes/media.php');
    require_once(ABSPATH . 'wp-admin/includes/image.php');

    // 获取当前表单提交实例
    $submission = WPCF7_Submission::get_instance();
    if (!$submission) return;

    // 提取表单提交数据与上传文件列表
    $posted_data = $submission->get_posted_data();
    $uploaded_files = $submission->uploaded_files();

    // 替换为你的CF7文件字段名称（对应表单短代码的name属性）
    $file_field_name = 'file';
    if (empty($uploaded_files[$file_field_name])) return;

    // 构建wp_handle_upload所需的标准文件数组
    $temp_file_path = $uploaded_files[$file_field_name];
    $file = [
        'name'     => basename($temp_file_path),
        'type'     => mime_content_type($temp_file_path),
        'tmp_name' => $temp_file_path,
        'error'    => 0,
        'size'     => filesize($temp_file_path)
    ];

    // 执行文件上传处理
    $movefile = wp_handle_upload($file, ['test_form' => false]);
    
    if ($movefile && !isset($movefile['error'])) {
        // 这里替换为你的用户注册逻辑，确保已获取到新用户ID
        $user_id = wp_create_user(
            $posted_data['username'],
            $posted_data['password'],
            $posted_data['email']
        );
        
        // 将文件信息存入用户元数据
        update_user_meta($user_id, 'user_uploaded_file', $movefile);
    }
});

关键注意事项 #

• 文件字段名称匹配：确保$file_field_name与CF7表单中文件字段的name属性完全一致，比如表单短代码是[file user-document id="upload-doc"]，则名称为user-document
• 目录权限检查：确认WordPress的wp-content/uploads目录具备写入权限，否则会导致上传失败
• 错误排查方法：可在wp_handle_upload后添加var_dump($movefile);输出返回结果，常见错误包括文件大小超限、文件类型未被允许

内容的提问来源于stack exchange，提问作者Amirhossein Hajighorbani