README

Composer 插件，用于将 Drupal 包的元数据生成到 info 文件中。

默认情况下，从 https://drupal.org/ 下载的包（例如模块、主题和配置文件）将注入元数据信息到其 .info 或 .info.yml 文件中，这样 update.module 就可以判断已安装的相应版本是否过时。顺便说一句，如果您直接使用 GIT 下载包，例如使用 Composer 安装 -dev 版本，那么这些元数据信息将不存在，因此 update.module 将报告未知版本。

通过这种方式，您可以

• 为 .info 文件生成 ini 格式的版本信息
• 为 .info.yml 文件生成 YAML 格式的版本信息
• 通过在 Git 中进行一些操作来计算项目的重新构建版本字符串，这将在我们打包的分支上找到最新的发布标签，计算自那时以来的提交数量，并使用这些信息构建一个用于 Drupal 7 及更高版本版本特定依赖支持的复杂版本字符串

在 Drupal 7.x 的情况下，以下元数据将被注入到 .info 文件中

; Information add by drustack/composer-generate-metadata on 2017-02-18
project = "features"
core = "7.x"
version = "7.x-2.10+3-dev"
datestamp = "1487399547"

在 Drupal 8.x 的情况下，以下元数据将被注入到 .info.yml 文件中

# Information add by drustack/composer-generate-metadata on 2017-02-18
project: "features"
version: "8.x-3.2+1-dev"
datestamp: "1487399552"

安装

只需使用 composer 安装插件

$ composer require drustack/composer-generate-metadata:~2.0

配置

Drupal 项目未列在 Packagist 上。相反，Drupal.org 为 Composer 提供了自己的 Drupal 项目目录。因此，您需要将 Drupal.org 添加到您的 Drupal 网站中 composer.json 文件中的 Composer 仓库。

Drupal.org 提供了两个单独的 composer 仓库端点：一个用于 Drupal 7，一个用于 Drupal 8。

• 要使用 Composer 与 Drupal 7，请使用仓库 URL https://packages.drupal.org/7
• 要使用 Composer 与 Drupal 8，请使用仓库 URL https://packages.drupal.org/8

要从命令行添加仓库，您应该在您的仓库根目录中执行以下命令

$ composer config repositories.drupal composer https://packages.drupal.org/7

Composer 将自动更新您的 Drupal 网站的 composer.json 文件，其中包含以下格式的 repositories 对象

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://packages.drupal.org/7"
        }
    ]
}

示例

一个示例 composer.json

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://packages.drupal.org/7"
        }
    ],
    "require": {
        "drupal/drupal": "~7.54",
        "drupal/features": "2.x-dev",
        "drustack/composer-generate-metadata": "~2.0"
    }
}

许可证

• 代码在 GPL-2.0+ 许可下发布
• 文档在 CC BY 4.0 许可下发布

作者信息

• 黄浩森艾迪生
  • https://twitter.com/hswong3i
  • https://github.com/hswong3i