Fetch

MMO\core\events · 1 symbole · générée le 27 Oct 2026

class

Fetch

Dispatched to resolve a URL into a value: any registered listener that can answer it calls $event->setReturn($value) (Signal), and the caller reads it back via Signal::getReturn.

class MMO\core\events\Fetch extends MMO\core\events\Signal implements MMO\core\interfaces\iStoppableEvent use MMO\core\classes\tWithOptions, MMO\core\classes\tStoppableEvent

Espace de noms: MMO\core\events
Étend: Signal
Implémente: iStoppableEvent
Utilise les traits: tWithOptions, tStoppableEvent

Used e.g. to load configuration/i18n/xml files by URL, and by [`Container::Fetch`](https://mmoframework.fr/fr/documentation/mmo.core/php/helpers/Container.md#container-fetch).

Fetch::AddListener(function (Fetch $e) { if ($e->url->getScheme() === 'file') {$e->setReturn(file_get_contents((string)$e->url));} }); Fetch::Send($this, 'file:///path/to/data.json')->getReturn();

Index

	opts
	stopped
	url readonly
	addOptions($opts, $appendList)	Merge $opts into the existing options (through `merge`), rather than replacing them wholesale like `setOptions`.
	clearOptions()	Empty the options bag.
	getOption($key, $default)
	getOptions()
	isPropagationStopped()
	setOption($key, $value)	Set (or, with a null $value, remove) a single option.
	setOptions($opts)	Replace the whole options bag.
	stopPropagation()	Prevent any remaining listener in the current dispatch chain from being called.
	__clone()	A cloned event starts fresh: propagation is never considered stopped on the clone, even if it was on the original instance.
	__construct($origin, $url, $options)

Propriétés3

opts

protected array $opts = []

Type: array

stopped

protected $stopped = false

url

readonly

readonly MMO\core\helpers\Uri $url

Type: Uri

Méthodes10

addOptions($opts, $appendList)

tWithOptions.php:65

Merge $opts into the existing options (through merge), rather than replacing them wholesale like setOptions.

function addOptions(array $opts, bool $appendList = false): void

$opts	array	the options to merge in
$appendList = false	bool	if true, a list-valued option is appended to (rather than replaced by) the corresponding list in $opts -- see \MMO\core\arrays\merge for the exact semantics
retourne	void

$t->setOptions(['a' => 1, 'tags' => ['x']]); $t->addOptions(['b' => 2, 'tags' => ['y']]); $t->getOptions(); // ['a' => 1, 'tags' => ['y'], 'b' => 2] -- 'tags' is replaced, not appended ($appendList=false)

clearOptions()

tWithOptions.php:39

Empty the options bag.

function clearOptions(): void

retourne

void

$t->clearOptions(); // getOptions() === []

getOption($key, $default)

tWithOptions.php:49

function getOption(string $key, mixed $default = null): mixed

$key	string
$default = null	mixed	returned if $key is not set
retourne	mixed

$t->getOption('a', 'fallback'); // the current value of 'a', or 'fallback' if not set

getOptions()

tWithOptions.php:20

function getOptions(): array

retourne

array

every option currently set

$t->getOptions(); // ['a' => 1, 'tags' => ['x']]

isPropagationStopped()

tStoppableEvent.php:21

function isPropagationStopped(): bool

retourne bool true once stopPropagation has been called on this instance

setOption($key, $value)

tWithOptions.php:77

Set (or, with a null $value, remove) a single option.

function setOption(string $key, mixed $value): void

$key	string
$value	mixed	if null, the option is unset entirely rather than being set to null
retourne	void

$t->setOption('a', 1);

$t->setOption('a', null); // removes 'a' from getOptions()

setOptions($opts)

tWithOptions.php:30

Replace the whole options bag.

function setOptions(array $opts): void

$opts	array
retourne	void

$t->setOptions(['a' => 1]);

stopPropagation()

tStoppableEvent.php:29

Prevent any remaining listener in the current dispatch chain from being called.

function stopPropagation()

retourne

__clone()

tStoppableEvent.php:38

A cloned event starts fresh: propagation is never considered stopped on the clone, even if it was on the original instance.

function __clone()

retourne

__construct($origin, $url, $options)

Fetch.php:28

function __construct( object|string $origin, MMO\core\helpers\Uri|string $url, array $options = [] )

$origin	object \| string
$url	Uri \| string	the URL to resolve (a plain string is wrapped into a `Uri`)
$options = []	array

Membres hérités (16)

	Propriétés	Déclaré par	Description
	`Listeners`	Event
	`origin`	Event
	`returnValue`	Signal

Méthodes	Déclaré par	Description
`AddListener($handler, $order)`	Event	Register a listener directly (as opposed to `ConnectListeners`'s attribute-based discovery).
`ConnectListeners($obj)`	Event	Scan $obj's methods for #[Listen(EventClass::class)] attributes and register each one as a listener on the matching event class.
`DisconnectListeners($obj)`	Event	Undo a previous `ConnectListeners`: removes every listener that `connect` had registered for $obj on this event class.
`dispatch()`	Event	Invoke every `GetListeners` listener with $this.
`GetListeners()`	Event	Collect every listener for this class, including those registered on its parent classes (so a subclass event is also caught by listeners of its parent event), sorted by ascending $order (ties keep …
`getOrigin()`	Event
`getReturn()`	Signal
`HasListener($handler)`	Event
`hasReturn()`	Signal
`RemoveListener($handler)`	Event	Remove the last added handler from the listeners.
`Send($args)`	Event	Construct a new instance of this class with $args, then `dispatch` it to every listener.
`SetListenerOrder($handler, $order)`	Event	Change the order of an already-registered listener, whether added directly via `AddListener` or indirectly via `ConnectListeners` (which also stores its `[$obj, $methodName]` callables here).
`setReturn($value, $stop)`	Signal