orx0r/slim3-controller

Implementation of controller for Slim Framework v3

slim3-controller

![Software License][ico-license] ![Coverage Status][ico-scrutinizer] ![Total Downloads][ico-downloads], _(*1)

Implementation of controller for Slim Framework v3, _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require orx0r/slim3-controller, <sub>(*4)</sub>

## Usage

Please see [example](https://github.com/orx0r/slim3-controller/tree/master/example) how it works in action
``` php
// in index.php
$app->get('/hello/{name}', 'app\controllers\HelloController:index');

// in app/controllers/HelloController.php

namespace app\controllers;

use Orx0r\Slim\Controller\Controller;

class HelloController extends Controller
{
    public function actionIndex($name)
    {
        return $this->response->getBody()->write("Hello, $name");
    }
}

If you use one of template engine, you can use it in controller:, <sub>(*5)</sub>

// in index.php
$c = new \Slim\Container;

$c['view'] = function ($container) {
    $view = new \Slim\Views\Twig( __DIR__ . '/../templates');
    $view->addExtension(new \Slim\Views\TwigExtension(
        $container['router'],
        $container['request']->getUri()
    ));

    return $view;
};

$app->get('/hello/{name}', 'app\controllers\HelloController:index');

// in app/controllers/HelloController.php
public function actionIndex($name)
{
    return $this->render('hello/index.html', ['name' => $name]);
}

In small Slim app you can use controllerNamespace for resolving all your controllers in same namespace by specifying only controller name. It works without breaking your old code, <sub>(*6)</sub>

// register CallableResolver. pass second parameter as controllerNamespace
$c['callableResolver'] = function ($container) {
    return new CallableResolver($container, 'app\controllers');
};

$app->get('/hello/{name}', 'HelloController:index');

Testing

bash $ composer test, <sub>(*7)</sub>

Contributing

Please see CONTRIBUTING, <sub>(*8)</sub>

License

The MIT License (MIT). Please see License File for more information., <sub>(*9)</sub>