Documentação do Symfony - versão 3.1
Renderizada do repositório symfony-docs-pt-BR no Github
A Yahoo! oferece um excelente utilitário, chamado YUI Compressor, para minificar JavaScripts e folhas de estilo, assim, eles são carregados mais rapidamente. Graças ao Assetic, você pode tirar proveito desta ferramenta de forma muito fácil.
O YUI Compressor é escrito em Java e distribuído como um JAR. Faça o download do JAR
no site da Yahoo! e salve-o em app/Resources/java/yuicompressor.jar
.
Agora você precisa configurar dois filtros Assetic em sua aplicação, um para minificar os JavaScripts com o YUI Compressor e um para minificar as folhas de estilo:
1 2 3 4 5 6 7 | # app/config/config.yml
assetic:
filters:
yui_css:
jar: "%kernel.root_dir%/Resources/java/yuicompressor.jar"
yui_js:
jar: "%kernel.root_dir%/Resources/java/yuicompressor.jar"
|
1 2 3 4 5 6 7 8 9 | <!-- app/config/config.xml -->
<assetic:config>
<assetic:filter
name="yui_css"
jar="%kernel.root_dir%/Resources/java/yuicompressor.jar" />
<assetic:filter
name="yui_js"
jar="%kernel.root_dir%/Resources/java/yuicompressor.jar" />
</assetic:config>
|
1 2 3 4 5 6 7 8 9 10 11 | // app/config/config.php
$container->loadFromExtension('assetic', array(
'filters' => array(
'yui_css' => array(
'jar' => '%kernel.root_dir%/Resources/java/yuicompressor.jar',
),
'yui_js' => array(
'jar' => '%kernel.root_dir%/Resources/java/yuicompressor.jar',
),
),
));
|
Você agora tem acesso a dois novos filtros Assetic em sua aplicação:
yui_css
e yui_js
. Eles utilizarão o YUI Compressor para minificar
as folhas de estilo e JavaScripts, respectivamente.
Você agora tem o YUI Compressor configurado, mas nada vai acontecer até aplicar um desses filtros para um asset. Uma vez que os seus assets fazem parte da camada de visão, este trabalho é feito em seus templates:
1 2 3 | {% javascripts '@AcmeFooBundle/Resources/public/js/*' filter='yui_js' %}
<script src="{{ asset_url }}"></script>
{% endjavascripts %}
|
1 2 3 4 5 | <?php foreach ($view['assetic']->javascripts(
array('@AcmeFooBundle/Resources/public/js/*'),
array('yui_js')) as $url): ?>
<script src="<?php echo $view->escape($url) ?>"></script>
<?php endforeach; ?>
|
Note
O exemplo acima assume que você tem um bundle chamado AcmeFooBundle
e os seus arquivos JavaScript estão no diretório``Resources/public/js`` sob
o seu bundle. Entretante, isso não é importante - você pode incluir os seus arquivos
JavaScript, não importa onde eles estiverem.
Com a adição do filtro yui_js
para as tags asset acima, você deve agora ver
os JavaScripts minificados sendo carregados muito mais rápido. O mesmo processo
pode ser repetido para minificar as suas folhas de estilo.
1 2 3 | {% stylesheets '@AcmeFooBundle/Resources/public/css/*' filter='yui_css' %}
<link rel="stylesheet" type="text/css" media="screen" href="{{ asset_url }}" />
{% endstylesheets %}
|
1 2 3 4 5 | <?php foreach ($view['assetic']->stylesheets(
array('@AcmeFooBundle/Resources/public/css/*'),
array('yui_css')) as $url): ?>
<link rel="stylesheet" type="text/css" media="screen" href="<?php echo $view->escape($url) ?>" />
<?php endforeach; ?>
|
Os JavaScripts e as folhas de estilo minificados são muito difíceis de ler, e muito menos
depurar. Devido a isso, o Assetic permite desabilitar um certo filtro quando a sua
aplicação está no modo de depuração. Você pode fazer isso prefixando o nome do filtro
em seu template com um ponto de interrogação: ?
. Isto diz ao Assetic para apenas
aplicar esse filtro quando o modo de depuração está desligado.
1 2 3 | {% javascripts '@AcmeFooBundle/Resources/public/js/*' filter='?yui_js' %}
<script src="{{ asset_url }}"></script>
{% endjavascripts %}
|
1 2 3 4 5 | <?php foreach ($view['assetic']->javascripts(
array('@AcmeFooBundle/Resources/public/js/*'),
array('?yui_js')) as $url): ?>
<script src="<?php echo $view->escape($url) ?>"></script>
<?php endforeach; ?>
|