CONTROLLER

📅 2026/3/13 ✍️ Bullsoft

VSlim\Controller

VSlim\Controller 是给 MVC 用的轻量基类，帮助你在控制器里访问 App、View，并直接使用 render / redirect helper。

真理之源：

初始化

最常见的方式是把 App 传进去：

final class PageController extends VSlim\Controller
{
    public function __construct(VSlim\App $app)
    {
        parent::__construct($app);
    }
}

很多时候你会把 controller 先放进 Container：

$app->container()->set(PageController::class, new PageController($app));

主要能力

控制器常用 helper：

app()
view()
render()
render_with_layout()
redirect_to()
redirect_to_query()

render

final class PageController extends VSlim\Controller
{
    public function home(VSlim\Request $req): VSlim\Response
    {
        return $this->render('home.html', [
            'title' => 'Controller Demo',
            'name' => $req->param('name') ?: 'guest',
        ]);
    }
}

这里会复用 App 当前的 view 配置：

view_base_path
assets_prefix

render_with_layout

final class PageController extends VSlim\Controller
{
    public function page(): VSlim\Response
    {
        return $this->render_with_layout('home.html', 'layout.html', [
            'title' => 'Layout Demo',
        ]);
    }
}

redirect_to

final class PageController extends VSlim\Controller
{
    public function jump(string $name): VSlim\Response
    {
        return $this->redirect_to('users.show', ['name' => $name], 302);
    }
}

也支持带 query：

return $this->redirect_to_query(
    'users.show',
    ['name' => $name],
    ['from' => 'controller'],
    302
);

和普通 controller 的区别

VSlim 不强制你继承 VSlim\Controller。普通 PHP 类只要方法签名对，照样能当 route handler。

继承它的主要价值是：

少写 App / View 注入样板
统一使用 render / redirect helper
做简单页面控制器更方便