WordPress过滤器替换文章空图片alt为文件名的代码问题修复

需求说明 #

需要将WordPress文章内容中所有图片的空alt属性，替换为对应图片src路径中提取的文件名（不含文件后缀）。

现有问题代码 #

// replace empty alt
function replace_empty_alt($content){
    if (is_single()) {        
        // 匹配内容中 src="post_image.jpg" alt="" 结构
        $newAlt = preg_match_all('/[^\/]+(?=\.[^\/.]* alt="")/', $content, $matches);
        // 提取图片名称
        foreach ( $matches as $match) { 
            $imageNames = implode(',', $matches[0]);
        }
        // 转换为图片名称数组
        $imageNamesNew = explode(',', $urls);

        // 遍历替换内容中的空alt
        foreach ((array) $imageNamesNew as $imageNameNew) {
            $content = str_replace('alt=""', 'alt="'.$imageNameNew.'"', $content );

        }
        return $content;
    }
}

add_filter('the_content', 'replace_empty_alt');

错误运行效果 #

现有代码仅能将第一个空alt替换为正确文件名，后续所有空alt都会被替换为第一个图片的文件名，效果如下：

<img class="size-full aligncenter" src="image-name1.jpg" alt="image-name1" width="799" height="449">

<img class="size-full aligncenter" src="image-name2.jpg" alt="image-name1" width="799" height="449">

<img class="size-full aligncenter" src="image-name3.jpg" alt="image-name1" width="799" height="449">

预期正确效果 #

每个图片的空alt替换为自身src对应的文件名：

<img class="size-full aligncenter" src="image-name1.jpg" alt="image-name1" width="799" height="449">

<img class="size-full aligncenter" src="image-name2.jpg" alt="image-name2" width="799" height="449">

<img class="size-full aligncenter" src="image-name3.jpg" alt="image-name3" width="799" height="449">

错误原因 #

现有代码存在两个核心问题：

• 变量引用错误：explode 传入的$urls是未定义变量，实际应该使用前序步骤拼接得到的$imageNames
• 替换逻辑缺陷：使用全局str_replace替换所有alt=""，第一次循环就会把内容中所有空alt全部替换为第一个匹配到的文件名，后续循环找不到可替换的空alt，导致所有图片alt值相同

修复方案 #

使用preg_replace_callback在匹配到对应img标签时直接提取文件名完成替换，不需要单独提取文件名列表再循环替换，从逻辑上避免匹配错位：

function replace_empty_alt($content){
    if (is_single()) {
        // 匹配带空alt属性的img标签src片段
        $content = preg_replace_callback(
            '/src="([^"]+)"\s*alt=""/',
            function($matches){
                // 解析src路径，提取不含后缀的文件名作为alt值
                $fileInfo = pathinfo($matches[1]);
                $altText = $fileInfo['filename'];
                return 'src="' . $matches[1] . '" alt="' . $altText . '"';
            },
            $content
        );
    }
    return $content;
}
add_filter('the_content', 'replace_empty_alt');

提示：如果站点的img标签存在alt属性写在src属性之前、或者属性使用单引号的情况，可以适当放宽正则匹配规则即可适配，上述代码可以覆盖WordPress默认输出的所有图片结构场景。

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