WordPress含嵌套函数短码时编辑器崩溃求助

嘿，我来帮你彻底理清这个编辑器崩溃的问题！核心原因其实有两个，咱们一个个说：

1. 嵌套函数引发的PHP重复定义错误 #

PHP有个硬规则：同一个函数不能被重复定义。当你把lesson_slider放在mainslider_function内部定义时，每次外层的短码函数被调用（比如后台编辑页面加载、预览渲染），PHP都会尝试重新定义一次lesson_slider。第一次调用没问题，但第二次触发时，就会抛出Fatal error: Cannot redeclare lesson_slider()的致命错误——这个错误会直接中断后端代码执行，而古腾堡编辑器严重依赖后端返回的正常数据，一旦后端报错，前端的React逻辑就会直接崩掉，表现为编辑器停止运行。

你自己的测试代码也验证了这点：嵌套test()函数的写法，重复触发后就会触发报错，编辑器自然罢工。

2. 短码中直接用echo而非返回内容 #

WordPress的短码机制要求函数返回字符串内容，而不是直接用echo输出。当你在短码里直接echo滑块HTML时，这些内容会被提前插入到页面的HTML流中——在后台编辑器环境下，这会直接破坏编辑器的UI DOM结构（比如把滑块代码插到编辑器的工具栏或侧边栏代码里），导致编辑器的JavaScript逻辑混乱，最终也会引发崩溃。

针对这两个问题，咱们可以这样修改代码：

方案1：移除函数嵌套，拆分独立逻辑 #

把滑块逻辑抽成外层的独立函数，避免重复定义；同时改用字符串拼接收集内容，最后返回结果：

// 把滑块逻辑抽成独立函数，放在外层，只会定义一次
function lesson_slider() { 
    $output = '';
    $open_div = '<div class="autoplay">'; 
    $close_div = '</div>'; 

    if( have_rows('test_fields', 'option') ): 
        $output .= $open_div; 
        while ( have_rows('test_fields', 'option') ) : the_row(); 
            $sub_value = get_sub_field('image'); 
            // 增加URL合法性校验，避免无效输出和XSS风险
            if ($sub_value) {
                $output .= '<div class="slide"><img src="'.esc_url($sub_value).'"></div>';
            }
        endwhile; 
        $output .= $close_div; 
    endif; 

    return $output;
}

// 短码函数直接调用独立函数并返回结果
function mainslider_function() { 
    return lesson_slider(); 
}
// 记得注册短码（这一步很多人会忘）
add_shortcode('main_slider', 'mainslider_function');

方案2：直接合并逻辑到短码函数 #

如果不需要复用lesson_slider的逻辑，也可以直接把代码合并到短码函数里，完全避免嵌套：

function mainslider_function() { 
    $output = '';
    $open_div = '<div class="autoplay">'; 
    $close_div = '</div>'; 

    if( have_rows('test_fields', 'option') ): 
        $output .= $open_div; 
        while ( have_rows('test_fields', 'option') ) : the_row(); 
            $sub_value = get_sub_field('image'); 
            if ($sub_value) {
                $output .= '<div class="slide"><img src="'.esc_url($sub_value).'"></div>';
            }
        endwhile; 
        $output .= $close_div; 
    endif; 

    return $output;
}
add_shortcode('main_slider', 'mainslider_function');

• 始终用esc_url()处理用户输入的URL，避免XSS漏洞和无效链接；
• 短码里坚决不用echo，坚持return内容，这是WordPress短码的标准规范；
• 如果需要在编辑器里预览短码的样式，可以用enqueue_block_assets钩子加载滑块的CSS，让预览效果更贴近前端实际显示。

内容的提问来源于stack exchange，提问作者Victor S.