PHP插件监听系统开发问题：实例共享与事件注册时序

问题1：无法在index.php以外共享PluginEvent实例 #

原因分析 #

• define()无法存储对象类型，你用define('$event', $event)的操作会把对象转换为字符串Object存储，完全达不到共享实例的目的。
• 即使使用global $event，在命名空间类中也需要显式声明global $event才能访问，这种方式不仅繁琐，还不利于代码维护。
• 当前PluginEvent的getInstance()方法每次调用都会返回新实例，不是真正的单例，无法保证全局唯一。

解决方案：实现真正的单例模式 #

修改PluginEvent类，改为单例结构，确保全局只有一个事件实例：

<?php

namespace MythicalSystemsFramework\Plugins;

class PluginEvent
{
    protected array $listeners = [];
    protected array $onceListeners = [];
    // 新增静态私有实例属性
    private static ?PluginEvent $instance = null;

    // 私有化构造方法，禁止外部直接new
    private function __construct() {}

    // 禁止克隆实例
    private function __clone() {}

    // 禁止反序列化
    public function __wakeup() {}

    /**
     * Get the singleton instance of the PluginEvent class.
     */
    public static function getInstance(): PluginEvent
    {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }

    // 以下原有方法保持不变...
}

使用方式 #

• 在index.php中，无需手动实例化和定义全局变量，直接通过单例获取：

// 替换原来的$event = new PluginEvent();及后续global/define代码
$event = PluginEvent::getInstance();

• 在任意类（包括插件类）中，直接通过单例获取事件实例：

// 插件类的Event方法示例
public function Event() {
    $eventHandler = PluginEvent::getInstance();
    $eventHandler->on('app.onRoutesLoaded', function($router) {
        // 事件处理逻辑
    });
}

问题2：PluginsManager初始化时机早于事件注册，导致事件无法触发 #

原因分析 #

你的index.php执行顺序存在逻辑错误：

1. 先触发app.onRoutesLoaded事件
2. 再初始化PluginsManager加载插件

插件的事件监听器是在PluginsManager::init过程中注册的，此时目标事件已经触发完毕，自然无法捕获到事件。

解决方案：调整初始化与事件触发顺序 #

将PluginsManager::init的调用移到所有事件触发之前，确保插件先完成监听器注册，再触发事件：
修改index.php中的代码顺序：

// ... 原有代码 ...

/**
 * Get the renderer :).
 */
$renderer = Engine::getRenderer();

/*
 * 先初始化插件管理器，加载所有插件的事件监听器
 */
PluginsManager::init($router, $renderer, $event);

/*
 * Load the routes.
 */
api::registerApiRoutes($router);
App::registerRoutes($renderer);
// 插件已完成监听器注册，再触发事件
$event->emit('app.onRoutesLoaded', [$router]);

// ... 原有代码 ...

额外建议 #

如果框架中存在其他需要插件监听的事件，必须保证事件触发时机在PluginsManager::init之后，避免出现类似的漏触发问题。

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