Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
Auth	[ DIR ]	drwxr-sr-x	2023-03-29 20:58
Cookie	[ DIR ]	drwxr-sr-x	2023-03-29 20:58
Exception	[ DIR ]	drwxr-sr-x	2023-03-29 20:58
Proxy	[ DIR ]	drwxr-sr-x	2023-03-29 20:58
Response	[ DIR ]	drwxr-sr-x	2023-03-29 20:58
Transport	[ DIR ]	drwxr-sr-x	2023-03-29 20:58
Utility	[ DIR ]	drwxr-sr-x	2023-03-29 20:58
Auth.php	860 B	-rw-r--r--	2023-03-29 20:58
Autoload.php	9.12 KB	-rw-r--r--	2023-08-08 20:49
Capability.php	652 B	-rw-r--r--	2023-08-08 20:49
Cookie.php	15.03 KB	-rw-r--r--	2024-07-16 20:49
Exception.php	1.09 KB	-rw-r--r--	2023-03-29 20:58
HookManager.php	709 B	-rw-r--r--	2023-03-29 20:58
Hooks.php	2.96 KB	-rw-r--r--	2023-10-12 21:51
IdnaEncoder.php	12.16 KB	-rw-r--r--	2026-07-03 02:00
Ipv6.php	5.51 KB	-rw-r--r--	2026-07-03 02:00
Iri.php	29.03 KB	-rw-r--r--	2026-07-03 02:00
Port.php	1.47 KB	-rw-r--r--	2023-03-29 20:58
Proxy.php	867 B	-rw-r--r--	2023-03-29 20:58
Requests.php	33.2 KB	-rw-r--r--	2026-07-03 02:00
Response.php	4.18 KB	-rw-r--r--	2023-08-08 20:49
Session.php	8.89 KB	-rw-r--r--	2023-10-12 21:51
Ssl.php	5.3 KB	-rw-r--r--	2023-03-29 20:58
Transport.php	1.51 KB	-rw-r--r--	2023-03-29 20:58

Rename

<?php
/**
 * Handles adding and dispatching events
 *
 * @package Requests\EventDispatcher
 */

namespace WpOrg\Requests;

use WpOrg\Requests\Exception\InvalidArgument;
use WpOrg\Requests\HookManager;
use WpOrg\Requests\Utility\InputValidator;

/**
 * Handles adding and dispatching events
 *
 * @package Requests\EventDispatcher
 */
class Hooks implements HookManager {
	/**
	 * Registered callbacks for each hook
	 *
	 * @var array
	 */
	protected $hooks = [];

/**
	 * Register a callback for a hook
	 *
	 * @param string $hook Hook name
	 * @param callable $callback Function/method to call on event
	 * @param int $priority Priority number. <0 is executed earlier, >0 is executed later
	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $hook argument is not a string.
	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $callback argument is not callable.
	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $priority argument is not an integer.
	 */
	public function register($hook, $callback, $priority = 0) {
		if (is_string($hook) === false) {
			throw InvalidArgument::create(1, '$hook', 'string', gettype($hook));
		}

if (is_callable($callback) === false) {
			throw InvalidArgument::create(2, '$callback', 'callable', gettype($callback));
		}

if (InputValidator::is_numeric_array_key($priority) === false) {
			throw InvalidArgument::create(3, '$priority', 'integer', gettype($priority));
		}

if (!isset($this->hooks[$hook])) {
			$this->hooks[$hook] = [
				$priority => [],
			];
		} elseif (!isset($this->hooks[$hook][$priority])) {
			$this->hooks[$hook][$priority] = [];
		}

$this->hooks[$hook][$priority][] = $callback;
	}

/**
	 * Dispatch a message
	 *
	 * @param string $hook Hook name
	 * @param array $parameters Parameters to pass to callbacks
	 * @return boolean Successfulness
	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $hook argument is not a string.
	 * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $parameters argument is not an array.
	 */
	public function dispatch($hook, $parameters = []) {
		if (is_string($hook) === false) {
			throw InvalidArgument::create(1, '$hook', 'string', gettype($hook));
		}

// Check strictly against array, as Array* objects don't work in combination with `call_user_func_array()`.
		if (is_array($parameters) === false) {
			throw InvalidArgument::create(2, '$parameters', 'array', gettype($parameters));
		}

if (empty($this->hooks[$hook])) {
			return false;
		}

if (!empty($parameters)) {
			// Strip potential keys from the array to prevent them being interpreted as parameter names in PHP 8.0.
			$parameters = array_values($parameters);
		}

ksort($this->hooks[$hook]);

foreach ($this->hooks[$hook] as $priority => $hooked) {
			foreach ($hooked as $callback) {
				$callback(...$parameters);
			}
		}

return true;
	}

public function __wakeup() {
		throw new \LogicException( __CLASS__ . ' should never be unserialized' );
	}
}