README

Biurad PHP 模板 UI

biurad/php-templating 是一个为 PHP 7.2+ 创建的服务器端模板 UI，由 Divine Niiquaye 创建。这个库提供了与任何类型的模板系统工作所需的所有工具，并提供了结构化的解决方案来实施可由服务器端渲染的模板引擎（Twig、Stempler、Latte、Blade 或原生 PHP 模板）的分离。

📦 安装与基本用法

此项目需要 PHP 7.2 或更高版本。推荐的安装方法是使用 Composer。只需运行

$ composer require biurad/templating

此库附带三个高性能且动态的渲染器，适用于快速服务器端模板。它还支持多渲染（可以同时渲染为不同渲染器声明的模板）。

你不必担心为每个模板文件声明绝对路径。将存储设置在可以找到路径的地方，输入模板文件的名称。其余的将由它处理，返回渲染结果（最终的 HTML）。

use Biurad\UI\Renders\PhpNativeRender;
use Biurad\UI\Helper\SlotsHelper;
use Biurad\UI\FilesystemStorage;
use Biurad\UI\Template;

$filesystemLoader = new FilesystemStorage(__DIR__.'/views');
$templating = new Template($filesystemLoader);

// Before adding a template renderer, you can add a namespace path
// $templating->addNamespace('MyBundle', __DIR__ . '/vendor/company/package/Resources');

// Add a template compiler renderer to Template.
$phpRenderEngine = new PhpNativeRender();
$templating->addRender($phpRenderEngine);

// You can also render an absolute path except for the fact that, it is not cacheable.
echo $templating->render('hello', ['firstname' => 'Divine']);

// hello.phtml or hello.php or hello.html
Hello, <?= $this->escape($firstname) ?>!

📓 文档

在使用此库之前，请查阅深入的文档。有关高级用法、配置和定制的完整文档可以在 docs.divinenii.com 找到。

⏫ 升级

有关如何升级到此库的新版本的信息可以在 UPGRADE 中找到。

🏷️ 更新日志

遵循 SemVer。次要版本和补丁版本不应引入对代码库的破坏性更改；有关最近更改的更多信息，请参阅 CHANGELOG。

任何标记为 @internal 的类或方法都不打算在此库之外使用，并且可能在任何时候进行破坏性更改，因此请避免使用它们。

🛠️ 维护与支持

（此政策可能在未来发生变化，并且可以逐案作出例外。）

每当发布一个新的 补丁版本（例如 1.0.10，1.1.6）时，大约每个月一次。它仅包含错误修复，因此您可以安全地升级您的应用程序。
每当发布一个新的 次要版本（例如 1.1，1.2）时，每六个月一次：一次在六月，一次在十二月。它包含错误修复和新功能，但不包括任何破坏性更改，因此您可以安全地升级您的应用程序；
每当发布一个新的 主要版本（例如 1.0，2.0，3.0）时，每两年一次。它可以包含破坏性更改，因此您在升级之前可能需要在应用程序中进行一些更改。

当一个主要版本发布时，每个分支（X.0，X.1，X.2，X.3 和 X.4）的次要版本数量限制为五个。分支的最后一个次要版本（例如 1.4，2.4）被认为是 长期支持 (LTS) 版本，持续超过两年，而其他版本可以持续最多 8 个月。

在发布的版本的活动维护结束后，从 Biurad Lap 获得专业支持。.

🧪 测试

$ ./vendor/bin/phpunit

这将测试 divineniiquaye/php-rade 是否可在 PHP 7.4 或更高版本上运行。

🏛️ 管理与治理

该项目主要由 Divine Niiquaye Ibok 维护。欢迎贡献 👷‍♀️！要贡献，请熟悉我们的贡献指南。

如需报告安全漏洞，请使用 Biurad Security。我们将协调修复，并将解决方案最终提交到该项目中。

🙌 赞助商

您有兴趣赞助该项目的发展吗？请在 Patreon 上联系我们或查看 https://biurad.com/sponsor 以了解赞助方式。

biurad / templating

维护者

详细信息