README

此包通过使 twig 函数 asset 返回 gulp-rev 清单中映射的文件，帮助您在 symfony 项目中使用经过 gulp-rev 版本化的资产。

已弃用 此包已被弃用，并在 2019 年 11 月 symfony 2.8 支持结束时将被放弃。从版本 3.3 开始，symfony 包含了与该包相同功能的 json_manifest_path 选项，我建议使用该选项而不是此包。对于旧版本，建议将 symfony 更新到稳定版本并开始使用 json_manifest_path 选项。

安装

步骤 1. 使用 composer 下载

composer require irozgar/gulp-rev-versions-bundle

步骤 2. 将包添加到 AppKernel

<?php
// app/AppKernel.php

class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...
            new Irozgar\GulpRevVersionsBundle\IrozgarGulpRevVersionsBundle(),
        );
    }
}

步骤 3. 配置您的包

包的配置取决于 symfony 版本

Symfony 版本 < 3.1

现在您必须使包替换您资产的默认版本策略。为此，请将以下内容添加到您的 config.yml 文件中

# app/config/config.yml

irozgar_gulp_rev_versions:
    replace_default_version_strategy: ~
    
    # This section is needed only if you use symfony packages
    # packages in this list will use the version strategy
    packages:
        - one_package
        - another_package

警告如果您的 Symfony 版本是 3.0，则应使用 twig 的 1.x 版本，因为 twig 2.0 引入了一些更改，这些更改在该版本的 Symfony 支持结束后破坏了与该版本的兼容性（链接）。

Symfony 版本 >= 3.1 且 < 4.0

此 symfony 版本引入了新的配置版本策略的选项。

将以下内容添加到您的 config.yml 中，以告诉 symfony 应使用哪种版本策略

# app/config/config.yml

framework:
    # ...
    assets:
        version_strategy: irozgar_gulp_rev_versions.asset.gulp_rev_version_strategy
       
# ...

# This is only needed if using a custom path for the manifest file
irozgar_gulp_rev_versions:
    manifest_path: "your/custom/path/rev-manifest.json"

注意从 symfony 3.3 开始，框架包含了一个使用清单文件加载资产的版本策略。更多信息

配置清单文件路径

rev-manifest.json 文件的默认位置是 app/Resources/assets/rev-manifest.json。您可以通过在 config.yml 中添加以下行来自定义它

# app/config/config.yml

irozgar_gulp_rev_versions:
    manifest_path: "your/custom/path/rev-manifest.json"

注意所有路径都将相对于 %kernel.root_dir%

irozgar / gulp-rev-versions-bundle

维护者

详细信息