palabs/endpoint-bundle

Symfony Endpoint bundle

PaEndpointBundle

PaEndpointBundle add alternative to symfony controllers. Endpoint is a controller with only one method - execute(Request): Response, _(*1)

Features include:, _(*2)

• Simple and clean endpoint interface - only one request handler in one class
• Easy way to generate routes, e.g. $router->url(SomeEndpoint::class)
• Refactorable - no additional changes need if you move or rename endpoint
• No route names need (but if you want you can specify it in route definition)
• Supports for extending endpoints - you can define base endpoints and many childs with shared routes configuration. It's is very common task in crud controllers.

Installation

Add bundle to you composer.json:, _(*3)

composer require palabs/endpoint-bundle

Register bundle in Kernel:, _(*4)

// app/AppKernel.php

public function registerBundles()
{
    return [
        // ...
        new PaLabs\EndpointBundle\PaEndpointBundle(),
        // ...
    ];
}

Add route loading in app/config/routing.yml:, _(*5)

endpoints:
  resource: .
  type: endpoints

Usage

A simple endpoint look like, _(*6)

use PaLabs\EndpointBundle\EndpointInterface;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;

class TextEndpoint implements EndpointInterface {

    public function routes()
    {
       return new Route('/cool_message');
    }


    public function execute(Request $request): Response
    {
       return new Response('Hello, world');
    }
}