在开发 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 DIContainer; use SlimFactoryAppFactory; use SlimViewsTwig; use SlimViewsTwigMiddleware; 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('<p>Hi, my name is {{ name }}.</p>', $viewData); $response->getBody()->write($str); return $response; }); // 运行应用 $app->run();
不使用依赖注入容器
如果你不使用依赖注入容器，可以直接创建 Twig 实例并添加到应用中：
use SlimFactoryAppFactory; use SlimViewsTwig; use SlimViewsTwigMiddleware; 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( '<p>Hi, my name is {{ name }}.</p>', [ 'name' => $args['name'] ] ); $response->getBody()->write($str); return $response; }); // 运行应用 $app->run();
slim/twig-view 还提供了一些自定义的 Twig 函数，如 url_for()、full_url_for()、is_current_url() 等，这些函数可以帮助你生成 URL 和处理当前路径。例如：
<h1>User List</h1> <ul> <li><a href="https://www.php.cn/link/711dd708aad881a73d957f604eac03f9" rel="nofollow" target="_blank" >Josh</a></li> <li><a href="https://www.php.cn/link/711dd708aad881a73d957f604eac03f9" rel="nofollow" target="_blank" >Andrew</a></li> </ul>
通过使用 slim/twig-view，我不仅成功地将 Twig 集成到 Slim Framework 项目中，还大大提高了开发效率和代码的可读性。这个库的优势在于其易于安装和使用，同时提供了丰富的功能来支持复杂的模板需求。如果你在使用 Slim Framework 开发项目，并希望使用 Twig 作为模板引擎，slim/twig-view 无疑是一个非常不错的选择。
© 版权声明
文章版权归作者所有，未经允许请勿转载。
THE END
