Download the PHP package instaclick/require-js-bundle without Composer
On this page you can find all versions of the php package instaclick/require-js-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download instaclick/require-js-bundle
More information about instaclick/require-js-bundle
Files in instaclick/require-js-bundle
Package require-js-bundle
Short Description This bundle provides integration of the RequireJS library into Symfony2
License MIT
Informations about the package require-js-bundle
HearsayRequireJSBundle
Overview
This bundle provides integration of the RequireJS library into Symfony2.
Installation
1. Using Composer (recommended)
To install HearsayRequireJSBundle
with Composer just add the following to
your composer.json
file:
Note that the
master
branch is under development and unstable yet. If you want to use stable version then specify the1.0.*
version. However, remember that the1.0
branch no longer provides new features, only bug fixes.
Then, you can install the new dependencies by running Composer's update command
from the directory where your composer.json
file is located:
Now, Composer will automatically download all required files, and install them
for you. All that is left to do is to update your AppKernel.php
file, and
register the new bundle:
Configuration
This bundle configured under the hearsay_require_js
key in your application
configuration. This includes settings related to paths, shim, optimization, and
more.
- require_js_src
- initialize_template
- base_url
- base_dir
- paths
- shim
- options
- optimizer
- path
- hide_unoptimized_assets
- exclude
- options
- timeout
_require_jssrc
type: string default: //cdnjs.cloudflare.com/ajax/libs/require.js/2.1.8/require.min.js
This is a string that represents the template name which will render the RequireJS src or an URL to the RequireJS.
_initializetemplate
type: string default: HearsayRequireJSBundle::initialize.html.twig
This is a string that represents the template name which will render the RequireJS initialization output. You can pass into this template any extra options.
_baseurl
type: string default: js required
This is a string that represents the base URL where assets are served, relative to the website root directory. This URL also will exposed as an empty namespace.
_basedir
type: string default: null
This is a string that represents the base URL for the r.js optimizer, that is generally actually a filesystem path.
paths
type: array default: null
This is a prototype that represents an array of paths. Each path:
- includes the location and the key that determines whether the path is an external;
- the location can be a string as well as an array of values (paths fallbacks);
- the location can expose a file as well as a directory, if the location is a
file then MUST NOT ends with the
.js
file extension; - the location can referred to the files using a path like
@AcmeDemoBundle/Resources/public/js/src/modules
; - by default, is not an external;
- if specified as an external, will marked as an empty for the r.js optimizer;
- will exposed as a namespace.
shim
type: array default: null
This is a prototype that represents an array of shim, corresponds to the RequireJS shim config.
options
type: array default: null
An array of key-value pairs to pass to the RequireJS. The value can have variable type.
optimizer
type: array default: null
This block includes the r.js optimizer configuration options.
path
type: string default: null
This is a string that represents the path to the r.js optimizer.
_hide_unoptimizedassets
type: boolean default: false
This determines whether the r.js optimizer should suppress unoptimized files.
exclude
type: array default: []
An array of module names to exclude from the build profile.
options
type: array default: null
An array of key-value pairs to pass to the r.js optimizer. The value can have variable type.
timeout
type: integer default: 60
This determines the node.js process timeout, in seconds.
Full Default Configuration
Usage
Just output the RequireJS initialization and load files normally:
Alternately, you can specify a file to be required immediately via the
data-main
attribute:
If you need to do anything fancy with the configuration, you can do so manually by modifying the default configuration, and suppressing config output when initializing RequireJS:
To make global changes to the configuration/initialization output, you can specify an initialization template in your configuration:
To use this bundle with CoffeeScript, you can specify a path that contains
.coffee
scripts (means a directory). The scripts will renamed to .js
scripts.
Note that the
r.js
optimizer cannot optimize.coffee
scripts. However, you can apply the Assetic filter to this scripts by the file extension.
Optimization
This bundle provides the Assetic filter to create minified Javascript files using by r.js optimizer. This also inlines any module definitions required by the file being optimized. You need to provide a path to the r.js optimizer in your configuration to use the filter:
You can then use it like any other filter; for example, to optimize only in production:
Note that your configured path definitions will be incorporated into the optimizer filter, including the exclusion of external dependencies from the built profile's file.
If you wish to prevent unoptimized assets from being served (in e.g. production), you can suppress them:
If you're doing this, be sure that all the modules you need are bundled into your optimized assets (i.e. you're not accessing any modules by dynamic name, or if you are, then you're explicitly including those modules via optimizer options), otherwise you may see certain assets available in development, but not in production.
License
This bundle is released under the MIT license. See the complete license in the bundle:
Resources/meta/LICENSE
All versions of require-js-bundle with dependencies
symfony/finder Version >=2.0
symfony/yaml Version >=2.0
kriswallsmith/assetic Version >= 1.0
symfony/framework-bundle Version >=2.0.9