|
1 <?php |
|
2 /** |
|
3 * Handles adding and dispatching events |
|
4 * |
|
5 * @package Requests |
|
6 * @subpackage Utilities |
|
7 */ |
|
8 |
|
9 /** |
|
10 * Handles adding and dispatching events |
|
11 * |
|
12 * @package Requests |
|
13 * @subpackage Utilities |
|
14 */ |
|
15 class Requests_Hooks implements Requests_Hooker { |
|
16 /** |
|
17 * Registered callbacks for each hook |
|
18 * |
|
19 * @var array |
|
20 */ |
|
21 protected $hooks = array(); |
|
22 |
|
23 /** |
|
24 * Constructor |
|
25 */ |
|
26 public function __construct() { |
|
27 // pass |
|
28 } |
|
29 |
|
30 /** |
|
31 * Register a callback for a hook |
|
32 * |
|
33 * @param string $hook Hook name |
|
34 * @param callback $callback Function/method to call on event |
|
35 * @param int $priority Priority number. <0 is executed earlier, >0 is executed later |
|
36 */ |
|
37 public function register($hook, $callback, $priority = 0) { |
|
38 if (!isset($this->hooks[$hook])) { |
|
39 $this->hooks[$hook] = array(); |
|
40 } |
|
41 if (!isset($this->hooks[$hook][$priority])) { |
|
42 $this->hooks[$hook][$priority] = array(); |
|
43 } |
|
44 |
|
45 $this->hooks[$hook][$priority][] = $callback; |
|
46 } |
|
47 |
|
48 /** |
|
49 * Dispatch a message |
|
50 * |
|
51 * @param string $hook Hook name |
|
52 * @param array $parameters Parameters to pass to callbacks |
|
53 * @return boolean Successfulness |
|
54 */ |
|
55 public function dispatch($hook, $parameters = array()) { |
|
56 if (empty($this->hooks[$hook])) { |
|
57 return false; |
|
58 } |
|
59 |
|
60 foreach ($this->hooks[$hook] as $priority => $hooked) { |
|
61 foreach ($hooked as $callback) { |
|
62 call_user_func_array($callback, $parameters); |
|
63 } |
|
64 } |
|
65 |
|
66 return true; |
|
67 } |
|
68 } |