Download the PHP package erfans/asset-bundle without Composer
On this page you can find all versions of the php package erfans/asset-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package asset-bundle
The purpose of this bundle is to manage third party assets for reusable bundles.
Motivation
As it is mentioned in Symfony documentation:
A bundle should also not embed third-party libraries written in JavaScript, CSS or any other language.
Additionally due to license restrictions and conflicts a bundle may could not include third party assets (e.g. FOSCKEditorBundle).
To solve this situation, a bundle could only contain a configuration and by running a command line this bundle will install the configured assets.
This bundle allows to define multiple agents (downloader or installer)
service and tag them with erfans_asset.agent
and add alias
attribute to use them in the installing process.
Bundles can contain asset config files to install assets by proper agent.
(By now only Bower and File agents have been implemented.)
Installation
Applications that use Symfony Flex
Open a command console, enter your project directory and execute:
Applications that don't use Symfony Flex
Step 1: Download the Bundle
Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:
This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.
Step 2: Enable the Bundle
Then, enable the bundle by adding it to the list of registered bundles
in the app/AppKernel.php
file of your project:
Step 3: Configuration
Default configuration for "ErfansAssetBundle":
However, the usual necessary configurations are:
Please note, if you use Symfony2 you need to change the cash directory for bower configuration.
Step 3: Add asset config file
To define required third party assets for each bundle create an asset.yml
file
in Resources/config
directory of bundle.
Step 4: Install assets
To download and copy defined assets to the target folder run command erfans:asset:install
in Symfony console. You can limit the installing assets to specific bundles, by passing the
bundle names as arguments, e.g. erfans:asset:install AppBundle
.
The bower agent of this bundle is based on bowerphp which does not currently support the downloading assets by url. Therefore, a file installer is added to the bundle to download remote files and put them in the target directory.
Step 5: Add assets to frontend
Now you can add the installed assets to your twig or other asset loaders such
as RequireJs. If you used the public directory of a bundle as install directory,
then you need also to transfer them to public folder by assets:install
command.