[Summary view] [Print] [Text view]

   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  }