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

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

License

MIT

Credits

• Workerman
• Symfony Console
• FastRoute