rnaga/emit-php

A PHP framework to develop WebSocket, HTTP and FCGI Applications

dev-master 2017-03-23 00:32 UTC

Requires

• php: >=7.0.0

MIT

• Ryohei Nagatsuka

• http
• websocket
• EventEmitter
• fcgi

README

EmitPHP is a PHP framework that works with non-blocking I/O.

You can write your web applications and APIs in HTTP, FCGI and WebSocket.

As of now, this is an experimental project and there still exists errors and bugs.

Installation

• It requires PHP 7(CLI) and composer to run
• If you haven't installed composer, run below to install it.

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

• Download EmitPHP source code from github
• Run composer to create autoload

composer install

Now you can run Examples

Usage

WebSocket

Yes, EmitPHP supports WebSocket.

you can create your WebSocket Application with a few lines of code.

Below is an example of how to create a WebSocket Application.

// Create a new WS Application
$app = (new WSServer())->listen(4000)->app();
// Triggers when messages received
$app->on('message', function($conn, $msg){
    // Echo message
    $conn->send("echo => ". $msg);
    // Close the connection
    $conn->close();
});

\Emit\Loop();

HTTP

You can easily create a HTTP server as below

$server = (new HTTPServer())->listen(4000);
$server->on('request', function($req, $res){
    // Send response
    $res->send("Hello World");
    // Close connection
    $res->end();
});

\Emit\Loop();

Router

Example for using Router

$server = (new HTTPServer())->listen(9000);
// Create a new Route
$route = $server->route();
// Get method 
$route->get("/", function($req, $res, $next){
    $res->send("Hello World");
    // Calling the next handler
    $next();
});
// Register the route
$server->use($route);

\Emit\Loop();

FCGI

EmitPHP supports FCGI which works with Web Servers such as apache

$server = (new FCGIServer())->listen(9000);
$server->on('request', function($req, $res){
    // Send response
    $res->send("Hello World");
    // Close connection
    $res->end();
});

\Emit\Loop();

See examples for more details.

What's next

Please send me your feeback at [e-mail] and let me know how you like it. If there are demands, I will work more.

And if any of you wants to join the project, please let me know.

License

EmitPHP is licensed under the MIT license. See License File for more information.