Woocommerce结账后文件上传问题：$_FILES始终为空求助

问题根源分析 #

你遇到的$_FILES为空的情况，主要可能是以下几个原因：

1. 自定义文件字段未通过WooCommerce官方钩子注册，导致表单提交时字段未被正确识别
2. 前端可能存在JS代码清空了文件输入框的内容，导致提交时无文件数据
3. 钩子时机或代码细节（如未初始化数组）导致处理逻辑失效

具体修复步骤 #

1. 注册自定义文件字段到结账表单 #

仅通过woocommerce_form_field渲染字段是不够的，需要用woocommerce_checkout_fields钩子将字段正式添加到WooCommerce的结账字段列表中，确保表单提交时字段被正确处理：

public function init() {
    add_action('woocommerce_checkout_update_order_meta', [$this, 'saveCheckoutFields'], 10, 2);
    add_filter('woocommerce_form_field', [$this, 'woocommerce_file_form_field'], 10, 4);
    // 新增：注册自定义文件字段
    add_filter('woocommerce_checkout_fields', [$this, 'add_checkout_file_field']);
}

/**
 * 注册自定义文件字段到结账表单
 */
public function add_checkout_file_field($fields) {
    $fields['billing']['documente_medicale_file'] = [
        'type' => 'file',
        'label' => __('Documente medicale', 'woocommerce'),
        'required' => false,
        'class' => ['form-row-wide'],
        'input_class' => ['input-file'],
        'multiple' => true,
        'accept' => '.pdf,.jpg,.png',
        'max_size' => 10,
        'file_info_label' => __('Vă rugăm să încărcați documentele!', 'woocommerce'),
        'max_size_label' => __('Dimensiunea maximă a fiecărui fișier nu trebuie sa depășească 10MB. Se pot încărca maximum 5 fișiere.', 'woocommerce'),
        'input_label' => __('Încarcă fișierul', 'woocommerce')
    ];
    return $fields;
}

2. 修复文件保存逻辑 #

调整saveCheckoutFields函数，解决数组未初始化、文件验证缺失、权限不安全等问题：

public function saveCheckoutFields($order_id,$data) {
    // 保留原普通字段和选择字段保存代码...

    // Save file fields
    $additional_file_field = [
        'documente_medicale_file'
    ];

    foreach($additional_file_field as $field) {
        // 检查是否有上传文件
        if(!isset($_FILES[$field]) || empty($_FILES[$field]['name'][0])) {
            error_log("No files uploaded for field: $field");
            continue;
        }

        $files = $_FILES[$field];
        $file_count = count($files['name']);
        $file_urls = []; // 初始化数组，避免未定义警告

        $upload_dir = wp_upload_dir();
        $user_path = '/wc_checkout_uploads/'.$order_id;
        $user_folder = $upload_dir['basedir'].$user_path;
        $user_url = $upload_dir['baseurl'].$user_path;

        // 创建目录（wp_mkdir_p自动设置安全权限）
        if(!is_dir($user_folder)) {
            wp_mkdir_p($user_folder);
        }

        for($i = 0; $i < $file_count; $i++) {
            // 跳过空文件
            if(empty($files['name'][$i]) || empty($files['tmp_name'][$i])) continue;

            $file_name = sanitize_file_name($files['name'][$i]);
            $file_tmp = $files['tmp_name'][$i];
            $file_error = $files['error'][$i];

            // 检查上传错误
            if($file_error !== UPLOAD_ERR_OK) {
                error_log("Upload error for $file_name: $file_error");
                continue;
            }

            // 验证文件类型（可选，增强安全性）
            $allowed_ext = ['pdf', 'jpg', 'jpeg', 'png'];
            $file_ext = strtolower(pathinfo($file_name, PATHINFO_EXTENSION));
            if(!in_array($file_ext, $allowed_ext)) {
                error_log("Invalid file type: $file_ext");
                continue;
            }

            // 获取唯一文件名，避免覆盖
            $file_name = wp_unique_filename($user_folder, $file_name);
            $file_path = $user_folder.'/'.$file_name;
            $file_url = $user_url.'/'.$file_name;

            // 移动文件并设置安全权限
            if(move_uploaded_file($file_tmp, $file_path)) {
                chmod($file_path, 0644);
                $file_urls[] = $file_url;
            } else {
                error_log("Failed to move file: $file_name");
            }
        }

        if(!empty($file_urls)) {
            $concatenated_urls = implode(',', $file_urls);
            update_post_meta($order_id, $field, $concatenated_urls);
            error_log("Saved file URLs for order $order_id: $concatenated_urls");
        }
    }
}

3. 前端排查 #

• 确认结账表单存在enctype="multipart/form-data"属性（查看页面源码验证）
• 检查自定义JS代码，确保没有清空文件输入框的files属性，提交表单时输入框仍保留选中的文件

额外排查点 #

• 检查php.ini配置：确保upload_max_filesize和post_max_size设置为足够大的值（如10M以上）
• 查看服务器错误日志，确认是否存在文件上传权限不足的问题

内容的提问来源于stack exchange，提问作者Robert Crx