如何在Slim框架控制器中访问ServerRequestInterface

需求为移除HomeController的index方法中传递给view方法的$request参数，同时保证视图渲染功能正常运行。

现有代码 #

HomeController #

<?php
namespace App\Controllers;

use Psr\Http\Message\ResponseInterface as Response;
use Psr\Http\Message\ServerRequestInterface as Request;
use Slim\Views\Twig;


class HomeController extends Controller
{
    public function index(Request $request, Response $response, $args)
    {
        return $this->view($request, 'home', ['name' => 'text']);  // 需要移除此处的$request参数
    }
}

基类Controller #

<?php
namespace App\Controllers;

use Slim\Psr7\Factory\ServerRequestFactory;
use Slim\Views\Twig;
use Psr\Http\Message\ServerRequestInterface as Request;

class Controller
{
    public function view(Request $request, $tpl, $data)
    {
        $response = new \Slim\Psr7\Response();  // 此处可直接创建Response，无需外部传递
        $view = Twig::fromRequest($request); // 依赖Request实例，之前只能通过外部传入
        return $view->render($response, $tpl.'.html', $data);
    }
}

之前尝试的报错 #

自行解决时遇到两类典型错误：

• Uncaught Error: Cannot instantiate interface Psr\Http\Message\ServerRequestInterface：直接实例化了ServerRequestInterface接口（接口无法被实例化）
• Fatal error: Uncaught TypeError: Slim\Views\Twig::fromRequest(): Argument #1 ($request) must be of type Psr\Http\Message\ServerRequestInterface, string given：传入了非Request类型的参数给fromRequest方法

另外尝试单独加载Twig使用$twig->fetch()方法时，该方法不存在，且Slim要求响应体写入的内容必须为字符串。

解决方案 #

核心思路是通过依赖注入将Request实例注入到基类Controller中，让所有子类控制器直接使用，无需在方法间传递。

步骤1：修改基类Controller，构造函数注入Request #

<?php
namespace App\Controllers;

use Slim\Views\Twig;
use Psr\Http\Message\ServerRequestInterface as Request;

class Controller
{
    protected $request;

    // 构造函数注入当前请求的Request实例
    public function __construct(Request $request)
    {
        $this->request = $request;
    }

    public function view($tpl, $data)
    {
        $response = new \Slim\Psr7\Response();
        // 直接使用类内的$request属性，无需外部传入
        $view = Twig::fromRequest($this->request);
        return $view->render($response, $tpl.'.html', $data);
    }
}

步骤2：修改HomeController，移除view方法的$request参数 #

<?php
namespace App\Controllers;

use Psr\Http\Message\ResponseInterface as Response;
use Psr\Http\Message\ServerRequestInterface as Request;
use Slim\Views\Twig;


class HomeController extends Controller
{
    public function index(Request $request, Response $response, $args)
    {
        // 调用view时不再传递$request参数
        return $this->view('home', ['name' => 'text']);
    }
}

步骤3：确保容器支持依赖解析 #

Slim默认容器已支持PSR-7的依赖注入，只要控制器通过容器实例化（Slim路由默认会通过容器解析控制器），就会自动将当前请求的Request实例注入到基类构造函数中。

若项目使用自定义容器，需确保注册ServerRequestInterface的绑定：

// 容器配置示例
$container->set(Psr\Http\Message\ServerRequestInterface::class, function ($c) {
    return $c->get('request');
});

原理说明 #

• Slim处理请求时，会将当前的ServerRequestInterface实例存入容器
• 通过构造函数注入，基类Controller可直接获取当前请求实例，无需在每个方法中传递
• Twig::fromRequest()依赖请求实例获取Twig服务，现在通过类内属性直接调用即可

内容的提问来源于stack exchange，提问作者Alaksandar Jesus Gene