Class yii\console\controllers\AssetController

继承yii\console\controllers\AssetController » yii\console\Controller » yii\base\Controller » yii\base\Component » yii\base\BaseObject
实现yii\base\Configurable, yii\base\ViewContextInterface
可用自版本2.0
源代码 https://github.com/yiisoft/yii2/blob/master/framework/console/controllers/AssetController.php

Allows you to combine and compress your JavaScript and CSS files.

Usage:

  1. Create a configuration file using the template action:

    yii asset/template /path/to/myapp/config.php

  2. Edit the created config file, adjusting it for your web application needs.
  3. Run the 'compress' action, using created config:

    yii asset /path/to/myapp/config.php /path/to/myapp/config/assets_compressed.php

  4. Adjust your web application config to use compressed assets.

Note: in the console environment some path aliases like @webroot and @web may not exist, so corresponding paths inside the configuration should be specified directly.

Note: by default this command relies on an external tools to perform actual files compression, check $jsCompressor and $cssCompressor for more details.

公共属性

隐藏继承的属性

属性类型描述定义在
$action yii\base\Action The action that is currently being executed. yii\base\Controller
$assetManager yii\web\AssetManager Asset manager instance. yii\console\controllers\AssetController
$behaviors yii\base\Behavior[] 附加到此组件的行为列表. yii\base\Component
$bundles array List of asset bundles to be compressed. yii\console\controllers\AssetController
$color boolean Whether to enable ANSI color in the output. yii\console\Controller
$cssCompressor string|callable CSS file compressor. yii\console\controllers\AssetController
$defaultAction string Controller default action ID. yii\console\controllers\AssetController
$deleteSource boolean Whether to delete asset source files after compression. yii\console\controllers\AssetController
$help boolean Whether to display help information about current command. yii\console\Controller
$helpSummary string yii\console\Controller
$id string The ID of this controller. yii\base\Controller
$interactive boolean Whether to run the command interactively. yii\console\Controller
$jsCompressor string|callable JavaScript file compressor. yii\console\controllers\AssetController
$layout null|string|false The name of the layout to be applied to this controller's views. yii\base\Controller
$module yii\base\Module The module that this controller belongs to. yii\base\Controller
$modules yii\base\Module[] All ancestor modules that this controller is located within. yii\base\Controller
$passedOptionValues array The properties corresponding to the passed options yii\console\Controller
$passedOptions array The names of the options passed during execution yii\console\Controller
$route string The route (module ID, controller ID and action ID) of the current request. yii\base\Controller
$targets array List of asset bundles, which represents output compressed files. yii\console\controllers\AssetController
$uniqueId string The controller ID that is prefixed with the module ID (if any). yii\base\Controller
$view yii\base\View|yii\web\View The view object that can be used to render views or view files. yii\base\Controller
$viewPath string The directory containing the view files for this controller. yii\base\Controller

公共方法

隐藏继承的方法

方法描述定义在
__call() 调用不是类方法的指定的方法. yii\base\Component
__clone() 在通过克隆现有对象创建对象之后调用此方法. yii\base\Component
__construct() yii\base\Controller
__get() 返回组件属性的值. yii\base\Component
__isset() 检查属性是否已设置, 即已定义且不为null. yii\base\Component
__set() 设置组件属性的值. yii\base\Component
__unset() 将组件属性设置为null. yii\base\Component
actionCompress() Combines and compresses the asset files according to the given configuration. yii\console\controllers\AssetController
actionTemplate() Creates template of configuration file for actionCompress(). yii\console\controllers\AssetController
actions() Declares external actions for the controller. yii\base\Controller
afterAction() This method is invoked right after an action is executed. yii\base\Controller
ansiFormat() Formats a string with ANSI codes. yii\console\Controller
attachBehavior() 将行为附加到此组件. yii\base\Component
attachBehaviors() 将行为列表附加到组件. yii\base\Component
beforeAction() This method is invoked right before an action is executed. yii\base\Controller
behaviors() 返回此组件应该具有的行为列表. yii\base\Component
bindActionParams() Binds the parameters to the action. yii\console\Controller
canGetProperty() 返回一个值, 指示属性是否可读取. yii\base\Component
canSetProperty() 返回一个值, 指示属性是否可设置. yii\base\Component
className() 返回此类的完全限定名称. yii\base\BaseObject
combineCssFiles() Combines CSS files into a single one. yii\console\controllers\AssetController
combineJsFiles() Combines JavaScript files into a single one. yii\console\controllers\AssetController
confirm() Asks user to confirm by typing y or n. yii\console\Controller
createAction() Creates an action based on the given action ID. yii\base\Controller
detachBehavior() 从组件中分离一个行为. yii\base\Component
detachBehaviors() 分离组件中的所有行为. yii\base\Component
ensureBehaviors() 确保在 behaviors() 中声明的行为已附加到此组件. yii\base\Component
findLayoutFile() Finds the applicable layout file. yii\base\Controller
getActionArgsHelp() Returns the help information for the anonymous arguments for the action. yii\console\Controller
getActionHelp() Returns the detailed help information for the specified action. yii\console\Controller
getActionHelpSummary() Returns a one-line short summary describing the specified action. yii\console\Controller
getActionOptionsHelp() Returns the help information for the options for the action. yii\console\Controller
getAssetManager() Returns the asset manager instance. yii\console\controllers\AssetController
getBehavior() 返回指定的行为对象. yii\base\Component
getBehaviors() 返回附加到此组件的所有行为. yii\base\Component
getHelp() Returns help information for this controller. yii\console\Controller
getHelpSummary() Returns one-line short summary describing this controller. yii\console\Controller
getModules() Returns all ancestor modules of this controller. yii\base\Controller
getOptionValues() Returns properties corresponding to the options for the action id Child classes may override this method to specify possible properties. yii\console\Controller
getPassedOptionValues() Returns the properties corresponding to the passed options. yii\console\Controller
getPassedOptions() Returns the names of valid options passed during execution. yii\console\Controller
getRoute() Returns the route of the current request. yii\base\Controller
getUniqueId() Returns the unique ID of the controller. yii\base\Controller
getView() Returns the view object that can be used to render views or view files. yii\base\Controller
getViewPath() Returns the directory containing view files for this controller. yii\base\Controller
hasEventHandlers() 返回一个值, 指示是否有任何处理程序附加到指定的事件. yii\base\Component
hasMethod() 返回一个值, 指示方法是否已定义. yii\base\Component
hasProperty() 返回一个值, 指示属性是否已定义. yii\base\Component
init() 初始化对象. yii\base\BaseObject
isColorEnabled() Returns a value indicating whether ANSI color is enabled. yii\console\Controller
off() 从该组件分离现有的事件处理程序. yii\base\Component
on() 将事件处理程序附加到事件. yii\base\Component
optionAliases() Returns option alias names. yii\console\Controller
options() Returns the names of valid options for the action (id) An option requires the existence of a public member variable whose name is the option name. yii\console\Controller
prompt() Prompts the user for input and validates it. yii\console\Controller
render() Renders a view and applies layout if available. yii\base\Controller
renderContent() Renders a static string by applying a layout. yii\base\Controller
renderFile() Renders a view file. yii\base\Controller
renderPartial() Renders a view without applying layout. yii\base\Controller
run() Runs a request specified in terms of a route. yii\base\Controller
runAction() Runs an action with the specified action ID and parameters. yii\console\Controller
select() Gives the user an option to choose from. Giving '?' as an input will show a list of options to choose from and their explanations. yii\console\Controller
setAssetManager() Sets asset manager instance or configuration. yii\console\controllers\AssetController
setView() Sets the view object to be used by this controller. yii\base\Controller
setViewPath() Sets the directory that contains the view files. yii\base\Controller
stderr() Prints a string to STDERR. yii\console\Controller
stdout() Prints a string to STDOUT. yii\console\Controller
trigger() 触发事件. yii\base\Component

受保护的方法

隐藏继承的方法

方法描述定义在
adjustCssUrl() Adjusts CSS content allowing URL references pointing to the original resources. yii\console\controllers\AssetController
adjustDependency() Adjust dependencies between asset bundles in the way source bundles begin to depend on output ones. yii\console\controllers\AssetController
buildTarget() Builds output asset bundle. yii\console\controllers\AssetController
compressCssFiles() Compresses given CSS files and combines them into the single one. yii\console\controllers\AssetController
compressJsFiles() Compresses given JavaScript files and combines them into the single one. yii\console\controllers\AssetController
getActionMethodReflection() yii\console\Controller
loadBundles() Creates full list of source asset bundles. yii\console\controllers\AssetController
loadConfiguration() Applies configuration from the given file to self instance. yii\console\controllers\AssetController
loadDependency() Loads asset bundle dependencies recursively. yii\console\controllers\AssetController
loadTargets() Creates full list of output asset bundles. yii\console\controllers\AssetController
parseDocCommentDetail() Returns full description from the docblock. yii\console\Controller
parseDocCommentSummary() Returns the first line of docblock. yii\console\Controller
parseDocCommentTags() Parses the comment block into tags. yii\console\Controller
registerBundle() Registers asset bundles including their dependencies. yii\console\controllers\AssetController
saveTargets() Saves new asset bundles configuration. yii\console\controllers\AssetController

事件

隐藏继承的事件

事件类型描述定义在
EVENT_AFTER_ACTION yii\base\ActionEvent An event raised right after executing a controller action. yii\base\Controller
EVENT_BEFORE_ACTION yii\base\ActionEvent An event raised right before executing a controller action. yii\base\Controller

常量

隐藏继承的常量

常量描述定义在
EXIT_CODE_ERROR 1 Deprecated since 2.0.13. Use yii\console\ExitCode::UNSPECIFIED_ERROR instead. yii\console\Controller
EXIT_CODE_NORMAL 0 Deprecated since 2.0.13. Use yii\console\ExitCode::OK instead. yii\console\Controller

属性详情

$assetManager public 属性

Asset manager instance.

public yii\web\AssetManager getAssetManager ( )
public void setAssetManager ( $assetManager )
$bundles public 属性

List of asset bundles to be compressed.

public array $bundles = []
$cssCompressor public 属性

CSS file compressor. If a string, it is treated as shell command template, which should contain placeholders {from} - source file name - and {to} - output file name. Otherwise, it is treated as PHP callback, which should perform the compression.

Default value relies on usage of "YUI Compressor"

参见 https://github.com/yui/yuicompressor/.

public string|callable $cssCompressor 'java -jar yuicompressor.jar --type css {from} -o {to}'
$defaultAction public 属性

Controller default action ID.

public string $defaultAction 'compress'
$deleteSource public 属性 (可用自版本: 2.0.10)

Whether to delete asset source files after compression. This option affects only those bundles, which have yii\web\AssetBundle::$sourcePath is set.

public boolean $deleteSource false
$jsCompressor public 属性

JavaScript file compressor. If a string, it is treated as shell command template, which should contain placeholders {from} - source file name - and {to} - output file name. Otherwise, it is treated as PHP callback, which should perform the compression.

Default value relies on usage of "Closure Compiler"

参见 https://developers.google.com/closure/compiler/.

public string|callable $jsCompressor 'java -jar compiler.jar --js {from} --js_output_file {to}'
$targets public 属性

List of asset bundles, which represents output compressed files. You can specify the name of the output compressed file using 'css' and 'js' keys: For example:

'app\config\AllAsset' => [
    'js' => 'js/all-{hash}.js',
    'css' => 'css/all-{hash}.css',
    'depends' => [ ... ],
]

File names can contain placeholder "{hash}", which will be filled by the hash of the resulting file.

You may specify several target bundles in order to compress different groups of assets. In this case you should use 'depends' key to specify, which bundles should be covered with particular target bundle. You may leave 'depends' to be empty for single bundle, which will compress all remaining bundles in this case. For example:

'allShared' => [
    'js' => 'js/all-shared-{hash}.js',
    'css' => 'css/all-shared-{hash}.css',
    'depends' => [
        // Include all assets shared between 'backend' and 'frontend'
        'yii\web\YiiAsset',
        'app\assets\SharedAsset',
    ],
],
'allBackEnd' => [
    'js' => 'js/all-{hash}.js',
    'css' => 'css/all-{hash}.css',
    'depends' => [
        // Include only 'backend' assets:
        'app\assets\AdminAsset'
    ],
],
'allFrontEnd' => [
    'js' => 'js/all-{hash}.js',
    'css' => 'css/all-{hash}.css',
    'depends' => [], // Include all remaining assets
],
public array $targets = []

方法详情

actionCompress() public 方法

Combines and compresses the asset files according to the given configuration.

During the process new asset bundle configuration file will be created. You should replace your original asset bundle configuration with this file in order to use compressed files.

public void actionCompress ( $configFile, $bundleFile )
$configFile string

Configuration file name.

$bundleFile string

Output asset bundles configuration file name.

actionTemplate() public 方法

Creates template of configuration file for actionCompress().

public integer actionTemplate ( $configFile )
$configFile string

Output file name.

return integer

CLI exit code

throws yii\console\Exception

on failure.

adjustCssUrl() protected 方法

Adjusts CSS content allowing URL references pointing to the original resources.

protected string adjustCssUrl ( $cssContent, $inputFilePath, $outputFilePath )
$cssContent string

Source CSS content.

$inputFilePath string

Input CSS file name.

$outputFilePath string

Output CSS file name.

return string

Adjusted CSS content.

adjustDependency() protected 方法

Adjust dependencies between asset bundles in the way source bundles begin to depend on output ones.

protected yii\web\AssetBundle[] adjustDependency ( $targets, $bundles )
$targets yii\web\AssetBundle[]

Output asset bundles.

$bundles yii\web\AssetBundle[]

Source asset bundles.

return yii\web\AssetBundle[]

Output asset bundles.

buildTarget() protected 方法

Builds output asset bundle.

protected void buildTarget ( $target, $type, $bundles )
$target yii\web\AssetBundle

Output asset bundle

$type string

Either 'js' or 'css'.

$bundles yii\web\AssetBundle[]

Source asset bundles.

throws yii\console\Exception

on failure.

combineCssFiles() public 方法

Combines CSS files into a single one.

public void combineCssFiles ( $inputFiles, $outputFile )
$inputFiles array

Source file names.

$outputFile string

Output file name.

throws yii\console\Exception

on failure.

combineJsFiles() public 方法

Combines JavaScript files into a single one.

public void combineJsFiles ( $inputFiles, $outputFile )
$inputFiles array

Source file names.

$outputFile string

Output file name.

throws yii\console\Exception

on failure.

compressCssFiles() protected 方法

Compresses given CSS files and combines them into the single one.

protected void compressCssFiles ( $inputFiles, $outputFile )
$inputFiles array

List of source file names.

$outputFile string

Output file name.

throws yii\console\Exception

on failure

compressJsFiles() protected 方法

Compresses given JavaScript files and combines them into the single one.

protected void compressJsFiles ( $inputFiles, $outputFile )
$inputFiles array

List of source file names.

$outputFile string

Output file name.

throws yii\console\Exception

on failure

getAssetManager() public 方法

Returns the asset manager instance.

public yii\web\AssetManager getAssetManager ( )
return yii\web\AssetManager

Asset manager instance.

throws yii\console\Exception

on invalid configuration.

loadBundles() protected 方法

Creates full list of source asset bundles.

protected yii\web\AssetBundle[] loadBundles ( $bundles )
$bundles string[]

List of asset bundle names

return yii\web\AssetBundle[]

List of source asset bundles.

loadConfiguration() protected 方法

Applies configuration from the given file to self instance.

protected void loadConfiguration ( $configFile )
$configFile string

Configuration file name.

throws yii\console\Exception

on failure.

loadDependency() protected 方法

Loads asset bundle dependencies recursively.

protected void loadDependency ( $bundle, &$result )
$bundle yii\web\AssetBundle

Bundle instance

$result array

Already loaded bundles list.

throws yii\console\Exception

on failure.

loadTargets() protected 方法

Creates full list of output asset bundles.

protected yii\web\AssetBundle[] loadTargets ( $targets, $bundles )
$targets array

Output asset bundles configuration.

$bundles yii\web\AssetBundle[]

List of source asset bundles.

return yii\web\AssetBundle[]

List of output asset bundles.

throws yii\console\Exception

on failure.

registerBundle() protected 方法

Registers asset bundles including their dependencies.

protected void registerBundle ( $bundles, $name, &$registered )
$bundles yii\web\AssetBundle[]

Asset bundles list.

$name string

Bundle name.

$registered array

Stores already registered names.

throws yii\console\Exception

if circular dependency is detected.

saveTargets() protected 方法

Saves new asset bundles configuration.

protected void saveTargets ( $targets, $bundleFile )
$targets yii\web\AssetBundle[]

List of asset bundles to be saved.

$bundleFile string

Output file name.

throws yii\console\Exception

on failure.

setAssetManager() public 方法

Sets asset manager instance or configuration.

public void setAssetManager ( $assetManager )
$assetManager yii\web\AssetManager|array

Asset manager instance or its array configuration.

throws yii\console\Exception

on invalid argument type.