8000 Added "How to Use a Custom Version Strategy for Assets" by javiereguiluz · Pull Request #7141 · symfony/symfony-docs · GitHub
[go: up one dir, main page]
Skip to content

Added "How to Use a Custom Version Strategy for Assets" #7141

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 12 commits into from
Dec 12, 2016
Merged

Added "How to Use a Custom Version Strategy for Assets" #7141

Changes from 1 commit
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
4f530d8
Cookbook entry: Asset - Custom Version Strategy
teohhanhui Jul 5, 2015
80d0ca2
Simplified the intro
javiereguiluz Nov 15, 2016
40dff64
Minor updates to the doc and service config
javiereguiluz Nov 15, 2016
5971ce0
Removed an unneeded file
javiereguiluz Nov 15, 2016
c59cff6
Moved the article to its new location
javiereguiluz Nov 15, 2016
ab8fa54
Fixed a rebase error
javiereguiluz Nov 15, 2016
f038483
Removed an unneeded change
javiereguiluz Nov 15, 2016
482fda5
Minor rewords and fixes
javiereguiluz Nov 15, 2016
2830ba0
Added the missing doc label
javiereguiluz Nov 21, 2016
a02f3b3
Added the version_strategy option to the config reference
javiereguiluz Dec 8, 2016
981e82d
Misc fixes
javiereguiluz Dec 9, 2016
1399967
Fixed a label name
javiereguiluz Dec 9, 2016
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Simplified the intro
  • Loading branch information
@javiereguiluz
javiereguiluz committed Nov 15, 2016
commit 80d0ca2f4ba4730228aec6f44db13149a4dccd51
55 changes: 9 additions & 46 deletions cookbook/asset/custom_version_strategy.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,54 +7,17 @@ How to Use a Custom Version Strategy for Assets
.. versionadded:: 2.7
The Asset component was introduced in Symfony 2.7.

Symfony by default does not perform asset versioning. You can specify the
Asset versioning is a technique that improves the performance of web
applications by adding a version identifier to the URL of your static assets
(CSS, JavaScript, images, etc.) When the content of the asset changes, the
identifier changes and the browser is forced to download it again instead of
using the cached version.

Symfony supports the basic asset versioning thanks to the
:ref:`version <reference-framework-assets-version>` and
:ref:`version_format <reference-framework-assets-version-format>` configuration
options to add a simple version to all assets (or a specific set of assets
grouped as a :ref:`package <reference-framework-assets-packages>`):

.. configuration-block::

.. code-block:: yaml

# app/config/config.yml
framework:
assets:
version: "20150530"
version_format: "%%s?version=%%s"

.. code-block:: xml

<!-- app/config/config.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/services"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:framework="http://symfony.com/schema/dic/symfony"
xsi:schemaLocation="http://symfony.com/schema/dic/services
http://symfony.com/schema/dic/services/services-1.0.xsd
http://symfony.com/schema/dic/symfony
http://symfony.com/schema/dic/symfony/symfony-1.0.xsd"
>
<framework:config>
<framework:assets
version="20150530"
version-format="%%s?version=%%s"
/>
</framework:config>
</container>

.. code-block:: php

// app/config/config.php
$container->loadFromExtension('framework', array(
'assets' => array(
'version' => '20150530',
'version_format' => '%%s?version=%%s',
),
));

However, if you require more control, you need to create a custom version
strategy.
options. If your application requires a more advanced versioning, you can create
your own version strategy.

Default Package
---------------
Expand Down
0