8000 Added caution notes about the removal of AsseticBundle in 2.8/3.0 by javiereguiluz · Pull Request #5973 · symfony/symfony-docs · GitHub
[go: up one dir, main page]
Skip to content

Added caution notes about the removal of AsseticBundle in 2.8/3.0 #5973

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

Closed
wants to merge 4 commits into from
Closed

Added caution notes about the removal of AsseticBundle in 2.8/3.0 #5973

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
0764dff
Addee caution notes about the removal of AsseticBundle in 2.8/3.0
javiereguiluz Dec 7, 2015
d2e51da
Reworded the caution notes about AsseticBundle
javiereguiluz Dec 7, 2015
ee942d9
Fixed a typo
javiereguiluz Dec 7, 2015
8e896e6
Reworded everything
javiereguiluz Dec 9, 2015
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
Reworded everything
  • Loading branch information
@javiereguiluz
javiereguiluz committed Dec 9, 2015
commit 8e896e68a907582462b6c524dcc496e917a4f3a5
106 changes: 65 additions & 41 deletions cookbook/assetic/asset_management.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,66 +4,90 @@
How to Use Assetic for Asset Management
=======================================

.. caution::
Installing and Enabling Assetic
-------------------------------

Starting from Symfony 2.8, Assetic is no longer included by default in the
Symfony Standard Edition. Before using any of its features, install the
AsseticBundle executing this console command in your project:
Starting from Symfony 2.8, Assetic is no longer included by default in the
Symfony Standard Edition. Before using any of its features, install the
AsseticBundle executing this console command in your project:

.. code-block:: bash

$ composer require symfony/assetic-bundle

Then, enable the bundle by adding the following configuration under the
``asetic`` key:
Then, enable the bundle in the ``AppKernel`` file of your Symfony application::

.. configuration-block::
// app/AppKernel.php

.. code-block:: yaml
// ...
class AppKernel extends Kernel
{
// ...

# app/config/config.yml
assetic:
debug: "%kernel.debug%"
use_controller: false
filters:
cssrewrite: ~
public function registerBundles()
{
$bundles = array(
// ...
new Symfony\Bundle\AsseticBundle\AsseticBundle(),
);

# ...
// ...
}
}

.. code-block:: xml
Finally, add the following minimal configuration to enable Assetic support in
your application:

<!-- 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"
xmlns:twig="http://symfony.com/schema/dic/twig"
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">
.. configuration-block::

<assetic:config debug="%kernel.debug%" use-controller="%kernel.debug%">
<assetic:filters cssrewrite="null" />
</assetic:config>
.. code-block:: yaml

<!-- ... -->
</container>
# app/config/config.yml
assetic:
debug: "%kernel.debug%"
use_controller: false
filters:
cssrewrite: ~

.. code-block:: php
# ...

// app/config/config.php
.. code-block:: xml

$container->loadFromExtension('assetic', array(
'debug' => '%kernel.debug%',
'use_controller' => '%kernel.debug%',
'filters' => array(
'cssrewrite' => null,
),
// ...
));
<!-- 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"
xmlns:twig="http://symfony.com/schema/dic/twig"
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">

<assetic:config debug="%kernel.debug%" use-controller="%kernel.debug%">
<assetic:filters cssrewrite="null" />
</assetic:config>

<!-- ... -->
</container>

.. code-block:: php

// app/config/config.php

$container->loadFromExtension('assetic', array(
'debug' => '%kernel.debug%',
'use_controller' => '%kernel.debug%',
'filters' => array(
'cssrewrite' => null,
),
// ...
));

// ...

Introducing Assetic
-------------------

Assetic combines two major ideas: :ref:`assets <cookbook-assetic-assets>` and
:ref:`filters <cookbook-assetic-filters>`. The assets are files such as CSS,
Expand Down
0