自定义WordPress插件问题：短代码中PHP变量无法在页面显示

架构老林

2026-6-27

问题修复方案

核心原因是PHP函数拥有独立作用域，即便外部已定义$address变量，短代码函数内部默认无法直接访问它。以下是针对性修复方法：

方法1：若`$address`为全局变量

在短代码函数内用global关键字引入全局变量：

add_shortcode( "example", "ah_create_shortcode" );
function ah_create_shortcode() {
    global $address; // 将外部全局变量引入函数作用域
    $return_string = '';

    $return_string .= '<section class="ah-lots">';
    $return_string .= '<div>' . esc_html( $address ) . '</div>'; // 用esc_html转义输出，保障安全
    $return_string .= '<div>Test Line</div>';
    $return_string .= '</section>';

    return $return_string;
}

方法2：若`$address`是后台保存的选项值

如果$address是插件后台设置页面保存的配置，用WordPress的get_option()函数获取：

add_shortcode( "example", "ah_create_shortcode" );
function ah_create_shortcode() {
    // 替换'ah_address'为你实际保存地址的选项名
    $address = get_option( 'ah_address', '' );
    $return_string = '';

    $return_string .= '<section class="ah-lots">';
    $return_string .= '<div>' . esc_html( $address ) . '</div>';
    $return_string .= '<div>Test Line</div>';
    $return_string .= '</section>';

    return $return_string;
}

方法3：若`$address`是插件类的属性

如果插件基于类开发，$address是类的实例属性或静态属性：

add_shortcode( "example", "ah_create_shortcode" );
function ah_create_shortcode() {
    // 假设插件类为AH_Plugin，且使用单例模式
    $plugin = AH_Plugin::get_instance();
    $address = $plugin->address;

    // 若是静态属性，直接调用：$address = AH_Plugin::$address;

    $return_string = '';

    $return_string .= '<section class="ah-lots">';
    $return_string .= '<div>' . esc_html( $address ) . '</div>';
    $return_string .= '<div>Test Line</div>';
    $return_string .= '</section>';

    return $return_string;
}