README

MicroApp is a minimalist PHP micro-backend framework built to run on top of the fast Workerman HTTP server. It enables you to quickly create lightweight micro-backends using Symfony commands and attribute-based routing.

Features

• Minimal setup, rapid development for micro-backends
• Runs on Workerman for high-performance HTTP serving
• Attribute-based routes using PHP 8+ attributes
• Symfony Console integration for easy command management
• Configurable port, interface, and worker count
• Event Dispatcher for custom event handling
• Middleware Support for request/response processing

Getting Started

Dependencies

• PHP 8.1+
• Workerman
• Symfony Console
• FastRoute

Installation

Install MicroApp via Composer:

composer require crazy-goat/micro-app

Creating a Micro-Backend

1. Create a Symfony Application using MicroApp:

<?php 
# myapp.php
require __DIR__.'/../vendor/autoload.php';

use CrazyGoat\MicroApp\Attributes\Route;
use CrazyGoat\MicroApp\MicroApp;
use Workerman\Protocols\Http\Request;
use Workerman\Protocols\Http\Response;

class HelloWorldController
{
    #[Route]
    public function handle(Request $request): Response
    {
        return new Response(body:'Hello World');
    }
}

(new MicroApp())
        ->withController(new HelloWorldController())
        ->getApplication()
        ->run();

• Your controller must have at least one function with the #[Route] attribute.
• Each route function must accept a Request and return a Response.

1. Run your application:

Example:

php myapp.php server start --listen=127.0.0.1 --port=8081

Configuration Options

Server commands

• server start - Start the server
• server stop - Stop the server
• server restart - Restart the server
• server reload - Reload the server
• server status - Show the server status
• server connections - Show the server connections

Routing

To register a route, you must use the #[Route] attribute. You can provide HTTP method(s) (e.g., GET, POST) and a path. These parameters are directly passed to the nikic/FastRoute's addRoute method, allowing you to define flexible and powerful routing rules.

## examples
// register route to / with GET method
#[Route] 

// register the route to /hello/{name} with the GET method.
#[Route(pattern: '/hello/{name}')]  

Accessing the route parameters is as simple as accessing the $request->context['router']['arguments']['name'] array.

Event Dispatcher

MicroApp includes a simple Event Dispatcher that allows you to hook into various lifecycle events of the application. You can register listeners using the onEvent() method on your MicroApp instance.

Available Events

Example

(new MicroApp())
        ->withController(new HelloWorldController())
        ->onEvent('onConnect', function (TcpConnection $connection) {
            echo "Client connected from {" . $connection->getRemoteIp() . ":" . $connection->getRemotePort() . "}\n";
        })
        ->getApplication()
        ->run();

Middlewares

MicroApp supports middleware to process requests before they reach your controller and to modify responses before they are sent. Middlewares are classes that implement CrazyGoat\MicroApp\Middlewares\MiddlewareInterface. When registering middleware, you must provide an index. By default, the router middleware's index is 1000. Middlewares with an index lower than 1000 will execute before the router, allowing pre-processing of the request, while those with a higher index will execute after the router. Note that only one middleware can be registered per index.

Example Middleware

class MySimpleMiddleware implements MiddlewareInterface
{
    public function process(Request $request, callable $next): Response
    {
        // Pre-process request
        echo "Middleware executed before controller.\n";

        $response = $next($request); // Call the next middleware or controller

        // Post-process response
        echo "Middleware executed after controller.\n";

        return $response;
    }
}

// Registering the middleware
(new MicroApp())
        ->withMiddleware(new MySimpleMiddleware(), 0)
        ->withController(new HelloWorldController())
        ->getApplication()
        ->run();

License

MIT

Credits

• Workerman
• Symfony Console
• FastRoute