PHP 8.1下WordPress插入特色图片出现未定义变量警告求助

错误原因 #

PHP 8.1对未定义变量的警告机制更严格，PHP 7.4会静默忽略未声明的全局变量，但PHP 8.1会直接抛出警告。你代码中的$post是WordPress的全局变量，但在自定义函数insert_featured_image中未明确声明，导致变量未定义，进而触发读取null对象属性的警告。

修复方案 #

提供两种可靠的修复方式，推荐第二种（避免全局变量依赖）：

方式一：声明全局$post变量 #

在函数开头明确声明使用全局的$post变量，并增加非空判断：

add_filter( 'the_content', 'insert_featured_image', 20 );
function insert_featured_image( $content ) {
    global $post; // 声明使用全局$post变量
    if ( is_single() && ! is_admin() && $post ) { // 确保文章对象存在
        $feat_img = get_the_post_thumbnail($post->ID, 'post-single'); 
        return prefix_insert_after_paragraph( '<div class="top-featured-image">' . $feat_img . '</div>', 1, $content );
    }
    return $content;
}
// Parent Function that makes the magic happen
function prefix_insert_after_paragraph( $insertion, $paragraph_id, $content ) {
    $closing_p = '</p>';
    $paragraphs = explode( $closing_p, $content );
    foreach ($paragraphs as $index => $paragraph) {
        if ( trim( $paragraph ) ) {
            $paragraphs[$index] .= $closing_p;
        }
        if ( $paragraph_id == $index + 1 ) {
            $paragraphs[$index] .= $insertion;
        }
    }
    return implode( '', $paragraphs );
}

方式二：使用get_post()主动获取文章对象（推荐） #

通过WordPress内置函数get_post()获取当前文章对象，避免依赖全局变量，更符合编码规范：

add_filter( 'the_content', 'insert_featured_image', 20 );
function insert_featured_image( $content ) {
    if ( is_single() && ! is_admin() ) {
        $current_post = get_post(); // 获取当前文章对象
        if ( $current_post ) { // 验证文章对象有效性
            $feat_img = get_the_post_thumbnail($current_post->ID, 'post-single'); 
            return prefix_insert_after_paragraph( '<div class="top-featured-image">' . $feat_img . '</div>', 1, $content );
        }
    }
    return $content;
}
// Parent Function that makes the magic happen
function prefix_insert_after_paragraph( $insertion, $paragraph_id, $content ) {
    $closing_p = '</p>';
    $paragraphs = explode( $closing_p, $content );
    foreach ($paragraphs as $index => $paragraph) {
        if ( trim( $paragraph ) ) {
            $paragraphs[$index] .= $closing_p;
        }
        if ( $paragraph_id == $index + 1 ) {
            $paragraphs[$index] .= $insertion;
        }
    }
    return implode( '', $paragraphs );
}

额外说明 #

• 增加文章对象的非空判断，能避免在非文章页面（如首页、归档页）执行代码时触发额外错误；
• 两种方式都能解决PHP 8.1下的警告问题，第二种方式更健壮，减少全局变量带来的耦合风险。

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