如何通过插件重写主题中的可插拔函数shz_get_images_property()避免激活时报错

首先得搞清楚你为什么会遇到这个致命错误——本质是主题里已经定义了shz_get_images_property()函数，而你的插件又尝试重新定义同名函数。虽然你提到主题用了function_exists()检查，但大概率是你误解了这个检查的位置：它可能是在函数内部做判断，而不是在函数定义时用if ( !function_exists() )包裹（这才是WordPress标准的可插拔函数写法）。

下面分两种情况给你解决方案：

情况一：主题里的函数是标准可插拔写法 #

先去主题index.php第71行看看，如果代码是这样的：

if ( ! function_exists( 'shz_get_images_property' ) ) {
    function shz_get_images_property() {
        // 主题原函数逻辑
    }
}

那问题就简单了！你只需要在插件文件里直接定义你的版本就行：

// 你的插件主文件中
function shz_get_images_property() {
    // 这里写你修改后的函数逻辑
    // 比如：
    // $images = get_post_meta(get_the_ID(), 'custom_images', true);
    // return $images ? array_map('wp_get_attachment_image_src', $images) : [];
}

原理是WordPress会先加载所有激活的插件，再加载主题模板文件。插件里先定义了函数，主题检测到函数已存在，就不会再执行原定义，自然不会报错。

情况二：主题里的函数直接定义（没有用if包裹） #

如果主题里的函数是直接写的（比如function shz_get_images_property() { ... }，没有if ( !function_exists() )判断），那直接在插件里定义同名函数肯定会冲突。这时候给你两个可选方案：

方案A：用runkit扩展替换函数（依赖服务器环境） #

如果你的服务器开启了PHP的runkit扩展（需要主机支持，大部分共享主机可能没开），可以用它重定义已存在的函数：

// 插件主文件中
add_action( 'plugins_loaded', function() {
    // 先检查runkit扩展是否可用
    if ( function_exists( 'runkit_function_redefine' ) ) {
        // 替换原函数为你的逻辑
        runkit_function_redefine( 'shz_get_images_property', function() {
            // 你的新函数代码
        } );
    } else {
        // 给管理员提示需要开启扩展
        add_action( 'admin_notices', function() {
            echo '<div class="notice notice-error"><p>需要开启PHP runkit扩展才能替换主题函数，请联系主机服务商。</p></div>';
        } );
    }
}, 100 );

这个方法最直接，但依赖环境，通用性不强。

方案B：用输出替换+自定义函数（通用但稍显hack） #

这个方法不需要特殊扩展，通过捕获模板输出替换函数调用来实现：

// 插件主文件中
// 第一步：定义你的自定义函数
function my_custom_shz_images_property( $args = [] ) {
    // 这里写你修改后的逻辑
    // 注意要和原函数的参数、返回值保持一致，避免主题调用出错
}

// 第二步：替换模板中的所有函数调用
add_action( 'template_redirect', function() {
    ob_start( function( $buffer_content ) {
        // 用正则替换所有函数调用（包括带参数的情况）
        return preg_replace(
            '/shz_get_images_property\((.*?)\)/',
            'my_custom_shz_images_property($1)',
            $buffer_content
        );
    } );
} );

注意：这个方法只能替换模板文件中直接输出的函数调用，如果主题在functions.php或其他PHP文件中直接调用该函数，替换不会生效。如果要覆盖这些场景，你可能需要用更复杂的代码（比如修改主题文件），但不推荐，风险较高。

最优建议 #

如果可以的话，最好联系主题开发者，让他们把shz_get_images_property()改成标准的可插拔写法（也就是用if ( !function_exists() )包裹定义），这样后续不管你怎么通过插件修改，都不会有冲突问题。

备注：内容来源于stack exchange，提问作者sed sajjad hoseinian