WordPress升级PHP8报字符串偏移访问错误排查修复

触发该致命错误的核心原因是PHP8版本对类型校验的规则升级，以及WordPress Shortcode回调的参数特性：

• PHP7及更早版本中，对字符串、null等非数组类型的值使用数组键访问（比如$str['key']）仅会抛出警告级提示，不会中断程序执行；PHP8将这类操作调整为致命TypeError，直接终止程序运行。
• WordPress的Shortcode回调函数接收的第一个参数$params，当Shortcode未传入任何属性（例如内容中直接写入[get_events_home]不带任何参数）时，传入的值是空字符串，而非空数组。
• 你当前代码在函数入口未做任何类型校验，直接执行$params['show_learn_more']、$params['post_per_page']操作，相当于在字符串类型上执行数组键访问，直接触发报错。
• 注释掉对应代码后，WordPress找不到该Shortcode的注册回调，会直接将Shortcode标签作为纯文本输出，因此出现Shortcode无法渲染的问题。

修复逻辑分三步：

1. 函数入口先对$params做强制数组转换，兼容无参数传入的场景
2. 访问数组键时使用PHP7+支持的空合并运算符??设置默认值，兼容键不存在的情况
3. 优化冗余的输出缓冲逻辑：ob_get_clean()本身会直接返回缓冲区内容并清空缓冲区，无需额外调用ob_get_contents()

修复后的完整代码如下：

// get event in home sortcode
function sc_get_events_home($params){
    // 强制转换参数为数组，兼容无shortcode属性传入的场景
    $params = (array)$params;
    // 用空合并运算符设置默认值，避免键不存在报错
    $showLearnMore = $params['show_learn_more'] ?? false;
    $numItems = $params['post_per_page'] ?? 3;
    $date_now = date('Ymd');
    $args = array(
            'post_type'         => 'events',
            'post_status'       => 'publish',
            'order'             => 'ASC',
            'orderby'           => 'when',
            'posts_per_page'    => $numItems,
            'meta_query'        => array(   
                                        array(
                                            'key'       => 'when',
                                            'value'     =>$date_now,
                                            'compare'   =>'>=',
                                            )
                                        )   
                );
    
    $query = new WP_Query( $args );
    $items = $query->posts;

    if(count($items) <3) { // upcoming < 3 -> get webinar resources

        // webinar newest
        $argsWbNewest   = array(
            'post_type'         => 'resources',
            'post_status'       => 'publish',
            'posts_per_page'    => 1,
            'order'             => 'DESC',
            'orderby'           => 'date',
            'tax_query'         => array(
                                        array(
                                            'taxonomy'  => 'type',
                                            'field'     => 'slug',
                                            'terms'     => array('webinars'),
                                            'operator'  => 'IN',
                                            )
                                        )       
                                );

        $queryWbNewest =  new WP_Query( $argsWbNewest );
        $itemsWbNewest = $queryWbNewest->posts;
        
        wp_reset_postdata();
        // webinar popular
        $argsWbPopular = array(
            'post_type'         => 'resources',
            'post_status'       => 'publish',
            'posts_per_page'    => 3,
            'meta_key'          => 'wpb_post_views_count', 
            'orderby'           => 'meta_value_num',
            'order'             => 'DESC'  ,
            'tax_query' => array(
                                array(
                                    'taxonomy'  => 'type',
                                    'field'     => 'slug',
                                    'terms'     => array('webinars'),
                                    'operator'  => 'IN',
                                    )
                                )
                            );

        $queryWbPopular = new WP_Query( $argsWbPopular );
        $itemsWbPopular = $queryWbPopular->posts;
        wp_reset_postdata();

    }
    
    ob_start();
       include 'view/sc-events-home.php';
       // 直接用ob_get_clean获取缓冲区内容，移除冗余调用
       $data = ob_get_clean();

    return $data;
}

add_shortcode( 'get_events_home', 'sc_get_events_home' );

如果你的Shortcode支持传入show_learn_more属性，注意在模板文件view/sc-events-home.php中使用$showLearnMore变量时，也建议做空值判断，避免变量未定义的提示。

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