如何限制WordPress特定图片上传字段的图片尺寸生成

针对多尺寸图片拖慢上传速度的问题，可以通过WordPress和ACF的钩子，根据不同上传场景（文章缩略图、ACF字段）过滤掉不需要生成的图片尺寸，具体实现如下：

一、限制文章特色图片生成的尺寸 #

使用intermediate_image_sizes钩子，识别文章编辑页的特色图片上传场景，仅保留所需尺寸：

add_filter('intermediate_image_sizes', 'limit_post_thumbnail_sizes', 10, 2);
function limit_post_thumbnail_sizes($sizes, $metadata) {
    // 判断当前是否为文章编辑页的特色图片上传操作
    if (isset($_POST['action']) && $_POST['action'] === 'upload-attachment' 
        && isset($_POST['_wp_http_referer']) && strpos($_POST['_wp_http_referer'], 'post.php') !== false) {
        
        // 替换为你实际需要保留的文章缩略图尺寸名称
        $allowed_sizes = array('post-thumbnail', 'featured-medium', 'featured-small');
        $sizes = array_intersect($sizes, $allowed_sizes);
    }
    return $sizes;
}

二、限制ACF图片字段生成的尺寸 #

利用ACF的acf/upload_prefilter钩子识别当前上传的字段，再动态过滤对应尺寸：

add_filter('acf/upload_prefilter', 'limit_acf_image_sizes');
function limit_acf_image_sizes($errors) {
    if (!isset($_POST['acf_field_key'])) return $errors;
    
    $field_key = $_POST['acf_field_key'];
    
    // 根据不同ACF字段key设置允许生成的尺寸
    switch ($field_key) {
        // 示例：产品图字段，仅保留产品相关尺寸
        case 'field_1234567890abc':
            add_filter('intermediate_image_sizes', function($sizes) {
                return array('product-thumb', 'product-gallery', 'product-detail');
            });
            break;
            
        // 示例：Banner字段，仅保留Banner适配尺寸
        case 'field_0987654321cba':
            add_filter('intermediate_image_sizes', function($sizes) {
                return array('banner-desktop', 'banner-tablet', 'banner-mobile');
            });
            break;
            
        // 可添加更多字段的判断逻辑
    }
    
    return $errors;
}

注意事项 #

• 确保你需要保留的尺寸已经通过add_image_size()函数在主题或插件中注册，否则过滤逻辑无效。
• 已上传的旧图片不会自动更新，可使用Regenerate Thumbnails类工具，选择仅生成所需尺寸来批量处理。
• 测试时需清空浏览器缓存，重新上传图片验证效果，避免缓存干扰。
• 若涉及批量上传场景，需补充额外的场景判断，防止误过滤其他上传操作。

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