WordPress中如何获取文件名作为图片ALT文本并去除扩展名与连字符？

咱们先拆解下你现有代码里的几个问题，再给出可行的解决方案：

1. 错误的数据源：你读取的_wp_attachment_image_alt本身就是ALT文本字段，不是原始文件路径，所以basename()根本拿不到真实的文件名
2. 冗余且不准确的上下文判断：wp_get_attachment_image_attributes过滤器已经提供了$attachment参数，直接用它就能定位到当前图片附件，不需要全局调用$post
3. 缺少扩展名去除和连字符处理：你提到文件名带连字符，也需要去掉扩展名，现有代码完全没处理这部分

修正后的代码 #

add_filter('wp_get_attachment_image_attributes', 'custom_product_image_alt_text', 20, 2);
function custom_product_image_alt_text($attr, $attachment) {
    // 获取当前图片附件的父级文章（也就是所属的产品）
    $parent_post = get_post($attachment->post_parent);
    
    // 只针对产品类型的图片进行处理
    if ($parent_post && $parent_post->post_type === 'product') {
        // 安全获取附件的文件URL
        $attachment_url = wp_get_attachment_url($attachment->ID);
        
        if ($attachment_url) {
            // 从URL中提取完整文件名（比如 "product-name-123.jpg"）
            $full_filename = basename($attachment_url);
            
            // 去掉文件扩展名，得到纯文件名（比如 "product-name-123"）
            $filename_without_ext = pathinfo($full_filename, PATHINFO_FILENAME);
            
            // 把连字符替换成空格，让ALT文本更符合阅读习惯（可选，不需要可以删除这行）
            $clean_alt_text = str_replace('-', ' ', $filename_without_ext);
            
            // 给ALT属性赋值
            $attr['alt'] = $clean_alt_text;
        }
    }
    
    return $attr;
}

代码细节说明 #

• 精准匹配产品图片：通过$attachment->post_parent确认当前图片属于产品文章，避免影响其他页面的图片
• 安全获取文件信息：使用WordPress官方函数wp_get_attachment_url()获取文件路径，比直接操作元数据更可靠
• 灵活的文件名处理：
  • pathinfo()专门用于处理文件路径，能稳妥地去掉扩展名
  • 可选的连字符替换，让ALT文本从product-name-123变成product name 123，更友好
• 可扩展逻辑：如果想要优先保留用户手动设置的ALT文本（仅当ALT为空时自动填充），可以在赋值前加个判断：

  if (empty($attr['alt'])) {
      $attr['alt'] = $clean_alt_text;
  }
  

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