README

简化 Latte 模板引擎资源重新加载的宏。生成版本或 git 提交哈希值，并将其附加到资源 URL 后，有效地强制浏览器重新加载它们。

还有宏可以获取包或项目本身的版本字符串。

注意：从 v2 版本开始不再支持 Composer v1。使用此包的 v1 版本来支持 Composer 版本 1 和 2。

使用方法

注册

首先，在 Latte 中注册宏，最好使用 NEON 配置文件

latte:
	macros:
		- @ElektroPotkan\LatteMacrosVersion\VersionMacros

services:
	- ElektroPotkan\LatteMacrosVersion\VersionMacros
	- ElektroPotkan\ProjectVersion\ProjectVersionGit

或直接在 PHP 中

$latte = new Latte\Engine;

$projectVersion = new ElektroPotkan\ProjectVersion\ProjectVersionGit;
$versionMacros = new ElektroPotkan\LatteMacrosVersion\VersionMacros($projectVersion);

$versionMacros->install($latte->getCompiler());

您还可以使用简单的项目版本占位符 ProjectVersionStatic 或任何实现 IProjectVersion 的其他类。

生成 URL

注册后，您可以在模板中使用宏，如下所示

<link rel="stylesheet" href="path-to-some-library-css/example.css?{VER vendor/example-project}" media="all" />
<link rel="stylesheet" href="css/style.css?{VER}" media="all" />

如果 vendor/example-project Composer 包的正常化版本为 4.2.18.0，并且项目本身没有标签，处于提交 9d23937，这将生成以下代码。

<link rel="stylesheet" href="path-to-some-library-css/example.css?_ver=4.2.18.0" media="all" />
<link rel="stylesheet" href="css/style.css?_ver=9d23937" media="all" />

版本字符串

您可以在模板中使用 VERSION 宏来获取版本字符串，例如

Library version: {VERSION vendor/example-project}<br>
Project version: {VERSION}

将生成

Library version: 4.2.18.0<br>
Project version: 9d23937

对于与上面示例相同的包版本。

作者

Elektro-potkan git@elektro-potkan.cz

信息

版本控制

此项目使用 语义版本控制 2.0.0 (semver.org)。

分支

此项目使用略微修改的 Git-Flow 工作流程和分支模型

• https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow
• https://nvie.com/posts/a-successful-git-branching-model/

许可

您可以在 BSD 零条款许可证或 GNU 通用公共许可证（GPL）版本 3 或更高版本下使用此程序。

请参阅文件 LICENSE。