README

The quickest and best framework you can start building on.

composer create-project nyholm/super-slim foobar-microservice

The idea

The idea of this framework is to give you a good foundation to start building your application. No file is sacred in this framework. It is you as a developer that are responsible for code and the dependencies you use.

If you eventually outgrow this framework, just replace Kernel.php with Symfony's Kernel and you are running a Symfony 4 application.

Performance

Below is a table of comparisons using a "hello world" application.

Looking only at "hello world" is not a good measurement for performance of a framework. You have to consider how well a large application is performing, specifically your large application. You do also have to consider how quick you can develop in a framework.

The table above is interesting if you are planning to build a small microservice that are similar to "hello world".

The architecture

The framework is quite simple, it consists of less than 5 classes. It follows the Middleware pattern and supports Symfony's HTTP Foundation.

index.php

Frontend controller, its job is to create a Request and give it to the Kernel.

Kernel

It creates a container from cache or from config then starts the Runner.

Runner

Runs the chain of middleware one by one in the order they are defined in the service declaration of App\Runner in services.yaml. The last middleware should be the router that calls one of your controller. The router will return a Response.

When the router middleware has returned a response the middleware will run again but backwards.

Router

The framework ships with two routers: App\Middleware\Router and App\Middleware\RouterForComplexRoutes. The former is using just simple if-statements to match the route with a controller. This is by far the quickest way if you only got a few routes. If you have more complex preg_match routing or a great number of them, you might be better of with RouterForComplexRoutes. It uses the Symfony 4 router which is the fastest generic router written in PHP.

Make sure you profile your application to see which router fits you better.

Controller

Here are your normal PHP classes and normal code. Your controllers should always return a Response.

Services

You are free to create how many services, value objects, database entities as you want. You can use config/services.yaml to register your services. By default they are autowired with the Symfony Dependency Injection container.

Configuration

It is simple to configure the application. You can use environment variables or the .env files for host specific configuration. If you want to register services or modify behavior then check the config/ folder.

If you know your way around Symfony configuration then you wont have any problem configuring SuperSlim.

Database

Your application may want to use a database. Just pick your favorite way to connect to your database and register it as a service. Here is an example using Doctrine.

composer require doctrine/orm

# config/packages/doctrine.yaml

services:
  doctrine.config:
    class: Doctrine\ORM\Configuration
    factory: Doctrine\ORM\Tools\Setup::createAnnotationMetadataConfiguration
    arguments:
      - ['%kernel.project_dir%/src']
      - 'kernel.debug'
      - null
      - null
      - false

  Doctrine\ORM\EntityManagerInterface:
    factory: Doctrine\ORM\EntityManager::create
    arguments:
      - { driver: pdo_mysql, url: '%env(resolve:DATABASE_URL)%' }
      - '@doctrine.config'

  doctrine.console_helper:
    class: Symfony\Component\Console\Helper\HelperSet
    public: true
    factory: Doctrine\ORM\Tools\Console\ConsoleRunner::createHelperSet
    arguments: ['@Doctrine\ORM\EntityManagerInterface']

# .env.local

DATABASE_URL=mysql://db_user:db_password@127.0.0.1:3306/db_name

namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity()
 * @ORM\Table(name="products")
 */
class Product
{
    /**
     * @ORM\Id()
     * @ORM\Column(type="integer")
     * @ORM\GeneratedValue()
     */
    protected $id;

    /**
     * @ORM\Column(type="string")
     */
    protected $name;

    public function getId()
    {
        return $this->id;
    }

    public function getName()
    {
        return $this->name;
    }

    public function setName($name)
    {
        $this->name = $name;
    }
}

If you want to enable CLI support:

// cli-config.php

use App\Kernel;

require __DIR__.'/config/bootstrap.php';

$kernel = new Kernel($_SERVER['APP_ENV'], (bool) $_SERVER['APP_DEBUG']);
$kernel->boot();

return $kernel->getContainer()->get('doctrine.console_helper');

vendor/bin/doctrine orm:schema-tool:update --force --dump-sql

Templating

Returning new Response('Hello world'); is not very fun. You probably want to use some templating. Pick you favorite tool and just register it as a service. Here is an example using Twig.

composer require twig/twig

# config/packages/twig.yaml

services:
  Twig\Loader\FilesystemLoader:
    arguments: ['%kernel.project_dir%/templates']

  Twig\Environment:
    arguments:
      - '@Twig\Loader\FilesystemLoader'
      - { cache: '%kernel.cache_dir%/templates' }

namespace App\Controller;

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Twig\Environment;

class MyTwigController
{
    private $twig;

    public function __construct(Environment $twig)
    {
        $this->twig = $twig;
    }

    public function index()
    {
        return new Response($this->twig->render('index.html.twig', ['name' => 'Foobar']));
    }
}

{# templates/index.html.twig #}

Hello {{ name }}!

Cache

Since you are building a small and super fast app, then caching is probably very important to you. Pick your favorite cache library and just register it as a service. Here is an example using Symfony Cache.

composer require symfony/cache

# config/packages/symfony_cache.yaml

services:
  symfony.cache.memcached:
    class: Symfony\Component\Cache\Adapter\MemcachedAdapter
    arguments: ['@native.memcached']

  native.memcached:
    class: Memcached
    factory: Symfony\Component\Cache\Adapter\MemcachedAdapter::createConnection
    arguments:
        - '%env(resolve:CACHE_URL)%'
        - { 'persistent_id': 'super_slim' }

Configure an alias for CacheInterface to use Memcached in production.

# config/services.yaml

services:
    Symfony\Contracts\Cache\CacheInterface: '@symfony.cache.memcached'

In development we want to use the Void cache.

# config/services_dev.yaml

services:
  Symfony\Contracts\Cache\CacheInterface: '@App\Service\VoidCache'

# .env.local

CACHE_URL=memcached://localhost

Then use the built in App\Middleware\Cache to cache each URL. Feel free to improve the creation of the cache key and other logic in this class.

namespace App\Middleware;

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Contracts\Cache\CacheInterface;
use Symfony\Contracts\Cache\ItemInterface;

class Cache implements MiddlewareInterface
{
    private $cache;

    public function __construct(CacheInterface $cache)
    {
        $this->cache = $cache;
    }

    public function __invoke(Request $request, RequestHandlerInterface $handler): Response
    {
        $cacheKey = sha1($request->getUri());

        return $this->cache->get($cacheKey, function (ItemInterface $item) use ($handler, $request) {
            $item->expiresAfter(3600);

            return $handler->handle($request);
        });
    }
}

The future of this framework

This small project is obviously not a competitor to any of the large frameworks and it should never be treated like that. It is just an exercise to show how easy it is to build small application based on Symfony components. And if one is using an architecture similar to SuperSlim there will not be any issues upgrading to a full Symfony framework when needed in the future.

I will treat this as a hobby project. If you like it, give it a star and fork it to turn it into something you like.

Or, you could read these great articles and build your own framework.

nyholm / super-slim

Maintainers

Details