Requirements

• PHP 7.1 or better
• Swoole extension is required for network server to work

Installation

Linux users:

pecl install swoole
composer install igniphp/network

Mac users with homebrew:

brew install swoole
composer install igniphp/network

or:

brew install homebrew/php/php71-swoole
composer install igniphp/network

Basic Usage

<?php// Autoloader.require_once__DIR__ . '/vendor/autoload.php';
// Create server instance.$server = new \Igni\Network\Server();
$server->start();

Listeners

Igni http server uses event-driven model that makes it easy to scale and extend.

There are five type of events available, each of them extends Igni\Network\Server\Listener interface:

• Igni\Network\Server\OnStartListener fired when server starts
• Igni\Network\Server\OnStopListener fired when server stops
• Igni\Network\Server\OnConnectListener fired when new client connects to the server
• Igni\Network\Server\OnCloseListener fired when connection with the client is closed
• Igni\Network\Server\OnRequestListener fired when new request is dispatched

<?php// Autoloader.require_once__DIR__ . '/vendor/autoload.php';
useIgni\Network\Server\Client;
useIgni\Network\Server\OnRequestListener;
usePsr\Http\Message\ServerRequestInterface;
usePsr\Http\Message\ResponseInterface;
useIgni\Network\Http\Stream;
// Create server instance.$server = new \Igni\Network\Server();
// Each request will retrieve 'Hello' response$server->addListener(newclassimplements OnRequestListener {
publicfunctiononRequest(Client$client, ServerRequestInterface$request, ResponseInterface$response): ResponseInterface {
return$response->withBody(Stream::fromString("Hello world"));
}
});
$server->start();

Configuration

Server can be easily configured with Igni\Network\Server\Configuration class.

Please consider following example:

<?php// Autoloader.require_once__DIR__ . '/vendor/autoload.php';
// Listen on localhost at port 80.$configuration = new \Igni\Network\Server\Configuration('0.0.0.0', 80);
// Create server instance.$server = new \Igni\Network\Server($configuration);
$server->start();

Enabling ssl support

<?php// Autoloader.require_once__DIR__ . '/vendor/autoload.php';
$configuration = new \Igni\Network\Server\Configuration();
$configuration->enableSsl($certFile, $keyFile);
// Create server instance.$server = new \Igni\Network\Server($configuration);
$server->start();

Running server as a daemon

<?php// Autoloader.require_once__DIR__ . '/vendor/autoload.php';
$configuration = new \Igni\Network\Server\Configuration();
$configuration->enableDaemon($pidFile);
// Create server instance.$server = new \Igni\Network\Server($configuration);
$server->start();

More examples can be found in the ./examples/ directory.