jsor/global-loop

A global event loop for ReactPHP.

v1.0.0 2017-08-21 10:09 UTC

Requires

• php: ^7.1
• react/event-loop: ^0.4

Requires (Dev)

• phpunit/phpunit: ^6.0

MIT

• Jan Sorgalla

• event-loop
• async
• asynchronous
• global
• reactphp

README

A global event loop for ReactPHP.

Installation

Install the latest version with Composer.

composer require jsor/global-loop

Check the Packagist page for all available versions.

Usage

Typical applications use a single event loop. ReactPHP requires that you pass the loop instance around, eg. as argument to functions and class constructors.

This library allows to use a single event loop instance from everywhere by providing static global accessors.

The only requirement is to call the static Jsor\GlobalLoop::run() at the end of your program.

<?php

// Application runs here

Jsor\GlobalLoop::run();

You can then access the global loop instance from from inside your application code by calling Jsor\GlobalLoop::get().

The default loop implementation is created using React\EventLoop\Factory::create() which picks the best available loop implementation.

If you want to use a specific or custom loop implementation, you can set it with Jsor\GlobalLoop::set() at the beginning of your program.

<?php

Jsor\GlobalLoop::set(new MyLoopImplementation());

// Application runs here

Jsor\GlobalLoop::run();

License

Copyright (c) 2017 Jan Sorgalla. Released under the MIT License.