Symfony2资产按文件进行版本控制


Symfony2 assets versioning by file

问题

是否可以在Symfony2上使用assets_version by file

背景

我们使用assets_version和assets_version_format来管理文件版本,并强制CDN和浏览器缓存上的缓存更新。

这真是太有魅力了!,但是,我们发现对于所使用的所有静态资源,只有一个assets_version参数。

这是一个问题,因为我们的网络应用程序有大量的静态资源,而且我们每天都在部署更改来刺激环境。这种情况会杀死缓存。:(

这是我们当前的配置:

配置yml

framework:
   
    templating:
        engines: ['twig']
        assets_version: %assets_version%
        assets_version_format:  "stv%%2$s/%%1$s"
# Assetic Configuration
assetic:
    debug:          %kernel.debug%
    use_controller: false
    # java: /usr/bin/java
    filters:
         cssrewrite: ~
         closure:
             jar: %kernel.root_dir%/java/compiler.jar
         yui_css:
             jar: %kernel.root_dir%/java/yuicompressor-2.4.6.jar

sometemplate.html.titch

    {% stylesheets 'bundles/webapp/css/funCommon.css'
                       'bundles/webapp/css/funMobile.css'
                       filter='?yui_css'
        %}
        <link rel=stylesheet href='{{ asset_url }}'>
        {% endstylesheets %}
    
    {% javascripts 'bundles/webapp/js/app.js'
                   'bundles/webapp/js/utils.js'
                    filter='?closure'  %}
        <script src="{{ asset_url }}"></script>
        {% endjavascripts %}
{% javascripts 'bundles/webapp/js/moduleX.js'
                   'bundles/webapp/js/utilsX.js'
                    filter='?closure'  %}
        <script src="{{ asset_url }}"></script>
        {% endjavascripts %}

当我更改任何css文件、模块JS或任何其他文件时,所有路径都会更改

我想通过javascript/stylesheet trick标记的参数来管理assets_version_format的版本参数

这就是我要找的:

{% javascripts 'bundles/webapp/js/app.js'
               'bundles/webapp/js/utils.js'
                filter='?closure' **version='XX'** %}
    <script src="{{ asset_url }}"></script>
    {% endjavascripts %}
  

经过几天的搜索,我在AsseticBundle 上找到了选项

http://symfony.com/doc/2.0/reference/configuration/framework.html#full-默认配置

使用这个配置选项,我可以做这样的事情:

{% javascripts file package='packageName' %}

{{asset(file,packageName)}}

样品:

配置yml

framework:
    templating:
        engines: ['twig']
        assets_version: %assets_version%
        assets_version_format:  "stv%%2$s/%%1$s"
        packages:
             css:
                version: 6.1
                version_format: "stv%%2$s/%%1$s"
             jsApp:
                version: 4.2
                version_format: "stv%%2$s/%%1$s"

sometemplate.html.titch

<link rel=stylesheet href='{{ asset('bundles/webapp/css/funCommon.css','css') }}'>
{% javascripts 'bundles/webapp/js/app.js'
               'bundles/webapp/js/utils.js'
                filter='?closure'
                package='jsApp'
 %}
    <script src="{{ asset_url }}"></script>
 {% endjavascripts %}

其输出为:

<link rel=stylesheet href="http://static.domain.com/stv6.1/css/HASH.css">
<script src="http://static.domain.com/stv4.2/js/HASH.js"></script>

对我来说,这是按文件版本管理资产的最简单方法。

如果您试图将assets_version参数与javascripts样式表帮助程序一起使用,那么您仍然需要使用assets辅助程序。

{% javascripts 'bundles/webapp/app.js'
               'bundles/webapp/utils.js'
               filter='?closure' %}
    <script src="{{ asset(asset_url) }}" type="text/javascript"></script>
{% endjavascripts %}

它不会自动添加到asset_url中(这是一件好事)。

一个简单快捷的解决方法如下:

{% set asset_version = 'xyz' %}
{% javascripts 'bundles/webapp/js/app.js'
           'bundles/webapp/js/utils.js'
            filter='?closure' %}
    <script src="{{ asset_url }}?{{ asset_version }}"></script>
{% endjavascripts %}

但您可能希望将逻辑移动到接收asset_url作为参数的trick扩展。

正常的过程是生成文件的散列,然后将其存储在用户缓存中。

然后,您可以在自定义命令中将所有哈希与当前哈希进行比较,并将最新的哈希或其他内容附加到文件名中,以强制更新缓存。

以下解决方案将附加时间戳而不是版本号。重要的是,只有当您清除缓存时,时间戳才会更改。

首先创建一个编译器过程:

<?php
namespace App'Bundle'DependencyInjection'Compiler;
use Symfony'Component'DependencyInjection'Compiler'CompilerPassInterface;
use Symfony'Component'DependencyInjection'ContainerBuilder;
use Symfony'Component'DependencyInjection'DefinitionDecorator;
/**
 * Created by PhpStorm.
 * User: hpenny
 * Date: 15/03/17
 * Time: 2:33 PM
 */
class AssetCompilerPass implements CompilerPassInterface
{
    /**
     * You can modify the container here before it is dumped to PHP code.
     *
     * @param ContainerBuilder $container
     */
    public function process(ContainerBuilder $container)
    {
        $container->removeDefinition('assets._version__default');
        $decorator = new DefinitionDecorator('assets.static_version_strategy');
        $decorator->replaceArgument(0, time());
        $container->setDefinition('assets._version__default', $decorator);
    }
}

然后将其添加到您的主捆绑包中:

namespace App'Bundle;
use App'Bundle'DependencyInjection'Compiler'AssetCompilerPass;
use Symfony'Component'DependencyInjection'ContainerBuilder;
use Symfony'Component'HttpKernel'Bundle'Bundle;
class AppBundle extends Bundle
{
    public function build(ContainerBuilder $container)
    {
        parent::build($container);
        $container->addCompilerPass(new AssetCompilerPass());
    }
}

这只适用于默认资产包。如果您正在使用该功能,则需要循环浏览已设置的不同包定义。

您需要更换assets._version_<package name>而不是assets._version__default