功能特色
- 支援單一事件綁定多個回呼
- 支援一次性事件(觸發後自動移除)
- 提供事件觸發、移除介面
核心類別實作
<?php
class Event {
protected static $listens = array();
public static function listen($event, $callback, $once = false) {
if (!is_callable($callback)) return false;
self::$listens[$event][] = array('callback' => $callback, 'once' => $once);
return true;
}
public static function one($event, $callback) {
return self::listen($event, $callback, true);
}
public static function remove($event, $index = null) {
if (is_null($index))
unset(self::$listens[$event]);
else
unset(self::$listens[$event][$index]);
}
public static function trigger() {
if (!func_num_args()) return;
$args = func_get_args();
$event = array_shift($args);
if (!isset(self::$listens[$event])) return false;
foreach ((array) self::$listens[$event] as $index => $listen) {
$callback = $listen['callback'];
$listen['once'] && self::remove($event, $index);
call_user_func_array($callback, $args);
}
}
}
?>
使用範例
<?php
// 綁定 walk 事件
Event::listen('walk', function() {
echo "I am walking...\n";
});
// 綁定一次性 walk 事件
Event::listen('walk', function() {
echo "I am listening...\n";
}, true);
// 觸發 walk 事件
Event::trigger('walk');
/* 輸出:
I am walking...
I am listening...
*/
Event::trigger('walk');
/* 輸出:
I am walking...
*/
// 使用 one 簡寫
Event::one('say', function($name = '') {
echo "I am {$name}\n";
});
Event::trigger('say', 'deeka'); // 輸出 I am deeka
Event::trigger('say', 'deeka'); // 不再執行
// 綁定物件方法
class Foo {
public function bar() {
echo "Foo::bar() is called\n";
}
public function test() {
echo "Foo::test() is called, args: " . json_encode(func_get_args()) . "\n";
}
}
$foo = new Foo;
Event::listen('bar', array($foo, 'bar'));
Event::trigger('bar');
Event::listen('test', array($foo, 'test'));
Event::trigger('test', 1, 2, 3);
// 綁定靜態方法
class Bar {
public static function foo() {
echo "Bar::foo() is called\n";
}
}
Event::listen('bar1', array('Bar', 'foo'));
Event::trigger('bar1');
Event::listen('bar2', 'Bar::foo');
Event::trigger('bar2');
// 綁定全域函數
function bar() {
echo "bar() is called\n";
}
Event::listen('bar3', 'bar');
Event::trigger('bar3');
?>
設計重點
- 靜態屬性
$listens 儲存事件與回呼對應表
once 標記實現一次性事件,觸發後自動 remove
call_user_func_array 支援任意參數傳遞給回呼
- 支援閉包、物件方法、靜態方法、全域函數等多種可呼叫類型