windwalker/controller

Windwalker Controller package

Windwalker Controller

The Windwalker Controller package is a simple interface to control some business logic, id didn't dependency to any other packages. You may integrate it to any systems., _(*1)

Installation via Composer

Add this to the require block in your composer.json., _(*2)

``` json { "require": { "windwalker/controller": "~2.0" } }, <sub>(*3)</sub>

## Create Your Controller

``` php
use Windwalker\Controller\Controller;

class IndexController extends AbstractController
{
    public function execute()
    {
        return 'Index';
    }
}

$controller = new IndexController;

$output = $contorller->execute();

Windwakler Controller is a "Single Action Controller", follows single responsibility principle, every controller just maintain one task(action). It is inspired from Joomla New MVC. You can create IndexController, CreateController, UpdateController and DeleteController for CRUD., <sub>(*4)</sub>

Using Input and Application

By default, controller maintains an input and an application object. We can set it when construct:, <sub>(*5)</sub>

``` php use Windwalker\Controller\Controller;, <sub>(*6)</sub>

class IndexController extends AbstractController { public function execute() { // Get params from http request $method = $this->input->get('_method');, <sub>(*7)</sub>

    $this->app->redirect('...');

    return true;
}

}, <sub>(*8)</sub>

$input = new Input; $app = new WebApplication;, <sub>(*9)</sub>

$controller = new IndexController($input, $app);, <sub>(*10)</sub>

$output = $contorller->execute();, <sub>(*11)</sub>

It didn't dependency to Windwalker self, you can push other framework's input and application into it:

``` php
$input = new Request;
$app = new HttpKernel;

$controller = new IndexController($input, $app);

$output = $contorller->execute();

HMVC

Using HMVC in Windwalker controller is very easy:, <sub>(*12)</sub>

``` php class IndexController extends AbstractController { public function execute() { $this->input->set('id', 123);, <sub>(*13)</sub>

    $foo = new FooController($this->input, $this->app);

    echo $foo->execute();

    return true;
}

}, <sub>(*14)</sub>

## Multi Action Controller

If you are familiar to common multiple action pattern, use `AbstractMultiActionController`:

``` php
use Windwalker\Controller\AbstractMultiActionController;

class ArticleController extends AbstractMultiActionController
{
    public function indexAction()
    {}

    public function saveAction($id = null, $data = array())
    {}

    public function deleteAction($id = null)
    {}
}

$controller = new ArticleController;

// Will call saveAction()
$controller->setActionName('save')
    ->setArguments(array(5, $data))
    ->execute();

If no action set, will call doExecute() instead, but you still need to override doExecute() first., <sub>(*15)</sub>