README

什么是项目版本？

项目版本是一个TYPO3扩展，它会在工具栏中添加一个条目到TYPO3系统信息。此条目基于常见的 'VERSION' 文件或本地GIT修订。

我如何安装它？

首先确保您符合要求

Composer

简单地从Packagist要求扩展：composer require kamiyang/ext-projectversion

或者如果您喜欢typo3-ter: composer require typo3-ter/projectversion

TER

没有composer？没问题！您也可以在TYPO3的扩展仓库（TER）中找到这个扩展。只要您的TYPO3不在composer模式下，您可以直接从您的TYPO3中下载它。

我如何使用它？

"VERSION"-文件

现在，这是最简单的一部分。在您的TYPO3前端docroot中创建一个名为 VERSION 的文件（大小写敏感），包含项目版本。可以这样完成：$ echo 1.0.0-rc.3 > /var/www/html/VERSION

自定义路径

您可以使用自己的文件名和路径。请注意，此路径仍然必须可以从您的web docroot访问。配置可以在扩展配置中完成。也可以更改 'VERSION' 文件的目录。只需提供目录路径（以斜杠 '/' 结尾）即可自动搜索名为 'VERSION' 的文件。

示例：我们假设Web文档根目录（PATH_site）是 /var/www/html。

GIT

从版本0.3.0开始支持git。这必须手动激活。为了使用git，请确保它可用！常见情况是本地开发环境基于docker镜像。许多docker镜像没有默认提供git。要激活它，只需通过您首选的Web浏览器移动到TYPO3后端。对于TYPO3 v8.7 - 前往 "Extensions > Project Version" 并配置扩展。默认情况下，配置屏幕将如下所示

在TYPO3 v9中，这有所变化。要配置扩展，请转到 "Settings > Configure extensions" 并过滤 "project version"。新的配置屏幕将如下所示

配置选项

basic.mode

basic.gitFormat

通往v1.0.0的道路

静态VERSION文件支持
添加配置"VERSION"-文件路径的能力
GIT修订支持
基于修订的GIT标签/分支支持
添加此扩展功能的文档
将扩展上传到packagist.org
将扩展上传到TER
支持TYPO3 v9.4
支持TYPO3 v9 LTS
实现95%以上的整体测试覆盖率
配置TravisCI
配置StyleCI
配置Coveralls
通过扩展配置静态VERSION值

v0.6.0的里程碑

通过TYPO3后端“硬编码”静态项目版本的能力

注意

此扩展的TYPO3 v8版本将在1.0.0版本发布后将不再维护！但这应该没问题，因为TYPO3 v8只会获得错误修复。这意味着，版本1.0.0应该与所有后续的TYPO3 v8版本保持兼容！

在发布版本1.0.0之后，大约在第一个TYPO3 v9 LTS版本发布时，EXT:project_version将重构为php7.2并整合TYPO3 v9的功能。

kamiyang / ext-projectversion

维护者

详细信息