Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commit560e010

Browse files
committed
Adding more details to be clear that you can set asset version globally or locally on an asset
1 parenta9648e8 commit560e010

File tree

3 files changed

+22
-14
lines changed

3 files changed

+22
-14
lines changed

‎book/templating.rst‎

Lines changed: 16 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -991,40 +991,43 @@ assets won't be cached when deployed. For example, ``/images/logo.png`` might
991991
look like ``/images/logo.png?v2``. For more information, see the:ref:`ref-framework-assets-version`
992992
configuration option.
993993

994+
.. _`
995+
994996
..versionadded::2.5
995-
AbsoluteURLsfor assets were introduced in Symfony 2.5.
997+
Setting versionedURLson an asset-by-asset basis were introduced in Symfony 2.5.
996998

997-
If you needabsolute URLsforassets, you can set thethird argument (or the
998-
``absolute`` argument) to``true``:
999+
If you needto set a versionfora specific asset, you can set thefourth
1000+
argument (or the ``version`` argument) tothe desired version:
9991001

10001002
..configuration-block::
10011003

10021004
..code-block::html+jinja
10031005

1004-
<img src="{{ asset('images/logo.png',absolute=true) }}" alt="Symfony!" />
1006+
<img src="{{ asset('images/logo.png',version=3.0) }}" alt="Symfony!" />
10051007

10061008
..code-block::html+php
10071009

1008-
<img src="<?php echo $view['assets']->getUrl('images/logo.png', null, true) ?>" alt="Symfony!" />
1010+
<img src="<?php echo $view['assets']->getUrl('images/logo.png', null, false, '3.0') ?>" alt="Symfony!" />
1011+
1012+
If you dont give a version or pass ``null``, the default package version
1013+
(from:ref:`ref-framework-assets-version`) wil be used. If you pass ``false``,
1014+
versioned URL will be deactivated for this asset.
10091015

10101016
..versionadded::2.5
1011-
Versioned URLs for assets were introduced in Symfony 2.5.
1017+
Absolute URLs for assets were introduced in Symfony 2.5.
10121018

1013-
If you needversioned URLs for assets, you can set thefourth argument (or the
1014-
``version`` argument) tothe desired version:
1019+
If you needabsolute URLs for assets, you can set thethird argument (or the
1020+
``absolute`` argument) to``true``:
10151021

10161022
..configuration-block::
10171023

10181024
..code-block::html+jinja
10191025

1020-
<img src="{{ asset('images/logo.png',version=3.0) }}" alt="Symfony!" />
1026+
<img src="{{ asset('images/logo.png',absolute=true) }}" alt="Symfony!" />
10211027

10221028
..code-block::html+php
10231029

1024-
<img src="<?php echo $view['assets']->getUrl('images/logo.png', null, false, '3.0') ?>" alt="Symfony!" />
1025-
1026-
If you dont give a version or pass ``null``, the default package version will
1027-
be used. If you pass ``false``, versioned URL will be deactivated.
1030+
<img src="<?php echo $view['assets']->getUrl('images/logo.png', null, true) ?>" alt="Symfony!" />
10281031

10291032
..index::
10301033
single: Templating; Including stylesheets and JavaScripts

‎components/templating/helpers/assetshelper.rst‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,8 @@ second is the version. For instance, ``%s?v=%s`` will be rendered as
8383
..versionadded::2.5
8484
On-demand versioned URLs for assets were introduced in Symfony 2.5.
8585

86-
You can also generate a versioned URL using the fourth argument of the helper:
86+
You can also generate a versioned URL on an asset-by-asset basis using the
87+
fourth argument of the helper:
8788

8889
..code-block::html+php
8990

‎reference/configuration/framework.rst‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -369,6 +369,10 @@ Now, the same asset will be rendered as ``/images/logo.png?v2`` If you use
369369
this feature, you **must** manually increment the ``assets_version`` value
370370
before each deployment so that the query parameters change.
371371

372+
It's also possible to set the version value on an asset-by-asset basis (instead
373+
of using the global version - e.g. ``v2`` - set here). See
374+
:ref:`Versioning by Asset<book-templating-version-by-asset>` for details.
375+
372376
You can also control how the query string works via the `assets_version_format`_
373377
option.
374378

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp