WordPress插件：跨类调用add_menu_page回调函数异常问题咨询

在自定义WordPress插件开发中，我在主Assets加载类里通过admin_menu钩子创建自定义后台菜单页。另外单独文件中有一个Leads_UI类，其中包含public static function leads_html()用于输出该自定义页面的HTML标记。

遇到以下异常：

• 当在register_leads_dashboard函数中，使用Leads_UI::leads_html()作为add_menu_page的回调参数时：
  1. 该HTML内容会在所有后台页面的左上角主内容区域后方显示；
  2. 点击后台的「Leads」菜单页时，会抛出404页面未找到错误。
• 但如果使用当前Assets类的leads_html方法作为回调（即[$this, 'leads_html']），则一切正常，仅在Leads页面输出内容。

作为面向对象编程新手，想了解问题的根本原因。

相关代码 #

Assets类代码 #

namespace MWS_PLUGIN\Inc;

use MWS_PLUGIN\Inc\Traits\Singleton;

class Assets {

    use Singleton;

    protected function __construct() {
        // 加载核心功能
        $this->setup_hooks();
    }

    protected function setup_hooks() {
        // 为Leads自定义文章类型添加新页面
        add_action( 'admin_menu', [$this, 'register_leads_dashboard'] );
    }

    public function register_leads_dashboard() {
        // 此写法会导致异常行为
        add_menu_page( __( 'Leads', 'my-plugin' ), __( 'Leads', 'my-plugin' ), 'manage_options', 'leads-list', Leads_UI::leads_html(), 'dashicons-admin-users', 50 );

        // 此写法完全正常
        //add_menu_page( __( 'Leads', 'my-plugin' ), __( 'Leads', 'my-plugin' ), 'manage_options', 'leads-list', [ $this, 'leads_html' ], 'dashicons-admin-users', 50 );
    }

    public function leads_html() {
        esc_html_e( 'Leads page test', 'my-plugin' );
    }
}

Leads_UI类代码 #

namespace MWS_PLUGIN\Inc;
    
class Leads_UI {
        
    private function __construct(){
    }
        
    public static function leads_html() {
        esc_html_e( 'Leads page test', 'my-plugin' );
    }
}

（错误效果：HTML内容显示在所有后台页面的左上角内容区域之后）

两个异常都是因为错误传递回调参数导致：

1. HTML全局显示的原因：
   add_menu_page的第5个参数需要的是可调用的回调函数引用，而非函数执行后的结果。当你写Leads_UI::leads_html()时，PHP会立即执行这个静态方法，把esc_html_e输出的文本作为参数传给add_menu_page。而admin_menu钩子会在所有后台页面加载时触发，因此每次打开任何后台页面，这个方法都会被执行一次，导致内容全局显示。

2. 404错误的原因：
   由于你传递的不是有效的可调用回调（而是函数执行后的字符串结果），WordPress无法找到该菜单页对应的处理逻辑。点击Leads菜单时，系统无法匹配到页面处理回调，因此返回404错误。

将回调参数修改为可调用的静态方法引用，有两种写法：

写法1：数组形式（推荐，符合WordPress OOP最佳实践） #

add_menu_page( 
    __( 'Leads', 'my-plugin' ), 
    __( 'Leads', 'my-plugin' ), 
    'manage_options', 
    'leads-list', 
    [Leads_UI::class, 'leads_html'], // 传递静态方法的类名和方法名
    'dashicons-admin-users', 
    50 
);

写法2：字符串形式 #

add_menu_page( 
    __( 'Leads', 'my-plugin' ), 
    __( 'Leads', 'my-plugin' ), 
    'manage_options', 
    'leads-list', 
    'Leads_UI::leads_html', // 直接传递静态方法的完整命名空间字符串
    'dashicons-admin-users', 
    50 
);

修改后，add_menu_page会收到正确的回调引用，只会在访问Leads页面时执行leads_html方法，同时WordPress能正确识别页面处理逻辑，解决404问题。

内容的提问来源于stack exchange，提问作者Mr.Coder