Commit cc351d06 by Carsten Brandt

tip about environment related asset config

fixes #3324
parent a03d87fe
...@@ -40,13 +40,13 @@ will be added AFTER `jquery.js`. Without this dependency specification, the rela ...@@ -40,13 +40,13 @@ will be added AFTER `jquery.js`. Without this dependency specification, the rela
`main.js` and `jquery.js` would be undefined. `main.js` and `jquery.js` would be undefined.
Like for [[yii\web\View::registerCssFile()|registerCssFile()]], it is also highly recommended that you use Like for [[yii\web\View::registerCssFile()|registerCssFile()]], it is also highly recommended that you use
[asset bundles](assets.md) to register external JS files rather than using [[yii\web\View::registerJsFile()|registerJsFile()]]. [asset bundles](structure-assets.md) to register external JS files rather than using [[yii\web\View::registerJsFile()|registerJsFile()]].
### Registering asset bundles ### Registering asset bundles
As was mentioned earlier it's preferred to use asset bundles instead of using CSS and JavaScript directly. You can get As was mentioned earlier it's preferred to use asset bundles instead of using CSS and JavaScript directly. You can get
details on how to define asset bundles in [asset manager](assets.md) section of the guide. As for using already defined details on how to define asset bundles in [asset manager](structure-assets.md) section of the guide. As for using already defined
asset bundle, it's very straightforward: asset bundle, it's very straightforward:
```php ```php
...@@ -90,6 +90,6 @@ The code above will add a link to CSS file to the head section of the page. ...@@ -90,6 +90,6 @@ The code above will add a link to CSS file to the head section of the page.
used instead. used instead.
It is highly recommended that you use [asset bundles](assets.md) to register external CSS files rather than It is highly recommended that you use [asset bundles](structure-assets.md) to register external CSS files rather than
using [[yii\web\View::registerCssFile()|registerCssFile()]]. Using asset bundles allows you to combine and compress using [[yii\web\View::registerCssFile()|registerCssFile()]]. Using asset bundles allows you to combine and compress
multiple CSS files, which is desirable for high traffic websites. multiple CSS files, which is desirable for high traffic websites.
...@@ -165,6 +165,16 @@ and corresponding values to set. ...@@ -165,6 +165,16 @@ and corresponding values to set.
Setting `sourcePath` to `null` tells asset manager not to copy anything while `js` overrides local files with a link Setting `sourcePath` to `null` tells asset manager not to copy anything while `js` overrides local files with a link
to CDN. to CDN.
> Tip: You may also use this procedure to configure different scripts dependent on the environment. For example
> use minified files in production and normal files in development:
>
> ```php
'yii\web\JqueryAsset' => [
'js' => [
YII_ENV_DEV ? 'jquery.js' : 'jquery.min.js'
]
],
```
Enabling symlinks Enabling symlinks
----------------- -----------------
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment