snicco/templating-bundle

v2.0.0-beta.9 2024-09-07 14:27 UTC

README

codecov Psalm Type-Coverage Psalm level PhpMetrics - Static Analysis PHP-Versions

WordPress 插件将 snicco/templating 集成到基于 snicco/kernel 的应用程序中。

安装

composer install snicco/templating-bundle

配置

请参阅 config/templating.php 了解可用的配置选项。

如果您的配置目录中没有此文件,则在开发模式下首次启动内核时将复制默认配置。

TemplatingBundle 添加到您的 bundles.php 配置文件中。

<?php
// /path/to/configuration/bundles.php

use Snicco\Bundle\Templating\TemplatingBundle;

return [
    
    'bundles' => [
        Snicco\Component\Kernel\ValueObject\Environment::ALL => [
           TemplatingBundle::class
        ]   
    ]   
];

用法

模板中间件

TemplatingBundle 提供了一个 TemplatingMiddleware,该中间件使用 snicco/templating 库的模板引擎来渲染 ViewResponses

它应该替换 http-routing-bundle 中的更简单的 SimpleTemplating 中间件。

视图上下文

当从启动的内核解析 TemplateEngine 时,以下上下文将在所有视图中可用

  • url => UrlGenerator 实例
  • view => TemplatEngine 实例本身

错误处理

如果使用 http-routing-bundle,则 TemplatingBundle 将注册一个 TemplatingExceptionDisplayer

此异常显示器可以添加到您的 http_error_handling 配置中。

它将根据 HTTP 状态码显示异常。

如果存在 path-to-templates/errors/403.phppath-to-templates/exceptions/403.php 模板文件,则状态码为 403 的异常将使用此显示器进行渲染。

可以为在 WordPress 管理区域内抛出的异常创建专门的异常模板。只需将 -admin 后缀添加到相应的文件名中,如下所示

path-to-templates/exceptions/403-admin.php

贡献

此存储库是 Snicco 项目 开发存储库的只读拆分。

以下是如何进行贡献的方法.

报告问题和发送拉取请求

请在 Snicco monorepo 中报告问题。

安全

如果您在 BetterWPCache 中发现安全漏洞,请遵循我们的 披露程序