在开发 slim framework 4 项目时，我遇到了一个挑战：如何在项目中整合一个高效且功能强大的模板引擎？尝试了多种方法后，我最终选择了 twig，并使用了 slim/twig-view 这个库来实现这一目标。
slim/twig-view 是一个专为 Slim Framework 4 设计的 Twig 模板引擎集成库。它不仅简化了 Twig 在 Slim 项目中的使用，还提供了许多实用的功能，如自动路径生成和模板缓存等。
使用 Composer 安装 slim/twig-view 非常简单：
composer require slim/twig-view
安装后，你可以轻松地在 Slim Framework 项目中使用 Twig。以下是两种常见的使用方法：
使用依赖注入容器（DI Container）
如果你使用依赖注入容器来管理 Slim 应用的依赖关系，可以按照以下步骤集成 Twig：
use DI\Container;
use Slim\Factory\AppFactory;
use Slim\Views\Twig;
use Slim\Views\TwigMiddleware;
require __DIR__ . '/../vendor/autoload.php';
// 创建容器
$container = new Container();
// 设置视图
$container->set(Twig::class, function() {
return Twig::create(__DIR__ . '/../templates', ['cache' => 'path/to/cache']);
});
// 从容器创建应用
$app = AppFactory::createFromContainer($container);
// 添加 Twig-View 中间件
$app->add(TwigMiddleware::create($app, $container->get(Twig::class)));
// 添加其他中间件
$app->addRoutingMiddleware();
$app->addErrorMiddleware(true, true, true);
// 从模板文件渲染
$app->get('/hello/{name}', function ($request, $response, $args) {
$viewData = [
'name' => $args['name'],
];
$twig = $this->get(Twig::class);
return $twig->render($response, 'profile.html.twig', $viewData);
})->setName('profile');
// 从字符串渲染
$app->get('/hi/{name}', function ($request, $response, $args) {
$viewData = [
'name' => $args['name'],
];
$twig = $this->get(Twig::class);
$str = $twig->fetchFromString('Hi, my name is {{ name }}.
', $viewData);
$response->getBody()->write($str);
return $response;
});
// 运行应用
$app->run();
不使用依赖注入容器
如果你不使用依赖注入容器，可以直接创建 Twig 实例并添加到应用中：
use Slim\Factory\AppFactory;
use Slim\Views\Twig;
use Slim\Views\TwigMiddleware;
require __DIR__ . '/../vendor/autoload.php';
// 创建应用
$app = AppFactory::create();
// 创建 Twig
$twig = Twig::create('path/to/templates', ['cache' => 'path/to/cache']);
// 添加 Twig-View 中间件
$app->add(TwigMiddleware::create($app, $twig));
// 定义命名路由
$app->get('/hello/{name}', function ($request, $response, $args) {
$view = Twig::fromRequest($request);
return $view->render($response, 'profile.html.twig', [
'name' => $args['name']
]);
})->setName('profile');
// 从字符串渲染
$app->get('/hi/{name}', function ($request, $response, $args) {
$view = Twig::fromRequest($request);
$str = $view->fetchFromString(
'Hi, my name is {{ name }}.
',
[
'name' => $args['name']
]
);
$response->getBody()->write($str);
return $response;
});
// 运行应用
$app->run();slim/twig-view 还提供了一些自定义的 Twig 函数，如 url_for()、full_url_for()、is_current_url() 等，这些函数可以帮助你生成 URL 和处理当前路径。例如：
User List
通过使用 slim/twig-view，我不仅成功地将 Twig 集成到 Slim Framework 项目中，还大大提高了开发效率和代码的可读性。这个库的优势在于其易于安装和使用，同时提供了丰富的功能来支持复杂的模板需求。如果你在使用 Slim Framework 开发项目，并希望使用 Twig 作为模板引擎，slim/twig-view 无疑是一个非常不错的选择。
