README

SlimController 是 Slim 框架的扩展，提供了 MVC 模式中的 C（控制器）。

仅使用 Slim，你可以非常快速地创建出色的应用程序。有时事情会变得复杂，你需要更多一点的结构——至少我是这样。这就是 SlimController 的用途。

通过 composer 安装

创建一个 composer.json 文件

{
    "require": {
        "slimcontroller/slimcontroller": "dev-master"
    },
    "autoload": {
        "psr-0": {
            "MyApp": "src/"
        }
    }
}

运行安装

composer.phar install --dev

简要指南

如果你了解 Slim 的工作原理，使用 SlimController 应该不是什么大问题。

示例结构

为你的控制器和模板设置一个结构（这只是个建议，按你喜欢的方式做）

mkdir -p src/MyApp/Controller templates

控制器

在 src/MyApp/Controller/Home.php 中创建你的第一个控制器

<?php

namespace MyApp\Controller;

class Home extends \SlimController\SlimController
{

    public function indexAction()
    {
        $this->render('home/index', array(
            'someVar' => date('c')
        ));
    }

    public function helloAction($name)
    {
        $this->render('home/hello', array(
            'name' => $name
        ));
    }
}

模板

这里有对应的两个示例模板

templates/home/index.php

This is the SlimController extension @ <?= $someVar ?>

templates/home/hello.php

Hello <?= $name ?>

Boostrap index.php

本示例的极简 Bootstrap 文件

<?php

// define a working directory
define('APP_PATH', dirname(__DIR__)); // PHP v5.3+

// load
require APP_PATH . '/vendor/autoload.php';

// init app
$app = New \SlimController\Slim(array(
    'templates.path'             => APP_PATH . '/templates',
    'controller.class_prefix'    => '\\MyApp\\Controller',
    'controller.method_suffix'   => 'Action',
    'controller.template_suffix' => 'php',
));

$app->addRoutes(array(
    '/'            => 'Home:index',
    '/hello/:name' => 'Home:hello',
));

$app->run();

运行

php -S localhost:8080

控制器

配置

controller.class_prefix

控制器类的可选前缀。将添加到路由之前。

使用 \\MyApp\\Controller 作为前缀，并给定路由

$app->addRoutes(array(
    '/'            => 'Home:index',
    '/hello/:name' => 'Home:hello',
));

转换为

$app->addRoutes(array(
    '/'            => '\\MyApp\\Controller\\Home:index',
    '/hello/:name' => '\\MyApp\\Controller\\Home:hello',
));

controller.method_suffix

可选方法后缀。添加到路由之后。

使用 Action 作为后缀，并给定路由

$app->addRoutes(array(
    '/'            => 'Home:index',
    '/hello/:name' => 'Home:hello',
));

转换为

$app->addRoutes(array(
    '/'            => 'Home:indexAction',
    '/hello/:name' => 'Home:helloAction',
));

controller.template_suffix

默认为 twig。将添加到 render() 方法中给定的模板名称之后。

扩展示例

路由

// how to integrate the Slim middleware
$app->addRoutes(array(
    '/' => array(
        'Home:index',
        function() {
            error_log("MIDDLWARE FOR SINGLE ROUTE");
        },
        function() {
            error_log("ADDITIONAL MIDDLWARE FOR SINGLE ROUTE");
        }
    ),
    '/hello/:name' => array(
        'Home:hello',
        'post',
        function() {
            error_log("THIS ROUTE IS ONLY POST");
        }
    )
), function() {
    error_log("APPENDED MIDDLEWARE FOR ALL ROUTES");
});

控制器

<?php

namespace MyApp\Controller;

class Sample extends \SlimController\SlimController
{

    public function indexAction()
    {

        /**
         * Access \SlimController\Slim $app
         */

        $this->app->response()->status(404);


        /**
         * Params
         */

        // reads "?data[foo]=some+value"
        $foo = $this->param('foo');

        // reads "data[bar][name]=some+value" only if POST!
        $bar = $this->param('bar.name', 'post');

        // all params of bar ("object attributes")
        //  "?data[bar][name]=me&data[bar][mood]=happy" only if POST!
        $bar = $this->param('bar');
        //error_log($bar['name']. ' is '. $bar['mood']);

        // reads multiple params in array
        $params = $this->params(array('foo', 'bar.name1', 'bar.name1'));
        //error_log($params['bar.name1']);

        // reads multiple params only if they are POST
        $params = $this->params(array('foo', 'bar.name1', 'bar.name1'), 'post');

        // reads multiple params only if they are POST and all are given!
        $params = $this->params(array('foo', 'bar.name1', 'bar.name1'), 'post', true);
        if (!$params) {
            error_log("Not all params given.. maybe some. Don't care");
        }

        // reads multiple params only if they are POST and replaces non given with defaults!
        $params = $this->params(array('foo', 'bar.name1', 'bar.name1'), 'post', array(
            'foo' => 'Some Default'
        ));


        /**
         * Redirect shortcut
         */

        if (false) {
            $this->redirect('/somewhere');
        }


        /**
         * Rendering
         */

        $this->render('folder/file', array(
            'foo' => 'bar'
        ));

    }
}