Class yii\web\AssetManager

PHP 回调：在复制每个子目录或文件成功之后调用。 此选项仅在发布目录时使用。回调的形式和 $beforeCopy 一样。

这个回调作为参数 afterCopy 传递给 yii\helpers\FileHelper::copyDirectory()。

是否将时间戳附加到每个已发布资源的 URL 上。 如果为 true，已发布资源的 URL 就会像 /path/to/asset?v=timestamp， 其中 timestamp 是已发布文件的最后修改时间。 通常情况下，你为资源启用 HTTP 缓存时，可将此属性设置为 true， 因为它会在你更新资源文件时刷新缓存。

源资源文件（键）和目标资源文件（值）的映射。

此属性用于支持在某些资源包中修复不正确的资源文件路径。 当资源包在视图中注册时，其 css 和 js 中的每个相对资源文件 都会被这个映射检查。如果找到相应的键， 将作为资源文件的最后部分（如果可用，以 yii\web\AssetBundle::$sourcePath 为前缀）， 相应的值将替换资源，并被注册到视图中。 例如，资源文件 my/path/to/jquery.js 匹配了 jquery.js。

请注意，目标资源文件必须为绝对 URL、相对于域名的 URL（以“/”开头）或者是 相对于 $baseUrl 和 $basePath 的路径。

在以下示例中，任何以 jquery.min.js 结尾的资源都会被替换成 jquery/dist/jquery.js， 其相对路径是 $baseUrl 和 $basePath。

[
    'jquery.min.js' => 'jquery/dist/jquery.js',
]

你还可以用别名指定映射的值，例如：

[
    'jquery.min.js' => '@web/js/jquery/jquery.js',
]

保存已发布的资源文件的根目录。

已发布资源文件可以访问的基链接。

PHP 回调：在复制每个子目录或文件之前调用。 此选项仅在发布目录时使用。如果回调返回 false， 则复制子目录或文件的操作将被取消。

回调的形式：function ($from, $to)，其中 $from 是子目录或者 要复制的文件，而 $to 是复制目标。

这个回调作为参数 beforeCopy 传递给 yii\helpers\FileHelper::copyDirectory()。

资源包配置列表。提供此属性是为了自定义资源包。 在 getBundle() 方法里，当一个资源包被加载，如果它在此处有相应的配置， 这些配置将应用于这个资源包。

数组的键是资源包名称，通常是资源包类名，没有反斜杠的那种。 数组的值是相应的配置，如果值为 false，则意味这 这个资源包被禁用，getBundle() 返回为 null。

如果此属性为 false，则意味全部的资源包都被禁用， getBundle() 会全部返回 null。

以下示例显示如何禁用 Bootstrap 小部件去使用 bootstrap 的 CSS。 （由于你想使用自己的样式）：

[
    'yii\bootstrap\BootstrapAsset' => [
        'css' => [],
    ],
]

资源编译器。

新创建的资源目录的权限。 此值将被 PHP 函数 chmod() 所使用。不设掩码（umask）。 默认值为 0775，意味着目录可以被拥有者和拥有组别读写， 但是其他用户只读。

新发布的资源文件的权限。 此值将被 PHP 函数 chmod() 所使用。不设掩码（umask）。 如果未设置，权限将由当前环境确定。

当目标目录已存在，正发布的目录是否应发布。 此选项仅在发布目录时使用。 你可能希望在开发阶段将其设置为 true 以确保已发布目录始终是最新的。 不要在生产服务器设置此属性， 它会显着降低性能。

PHP 回调：该回调函数将被调用以生成资源目录的哈希值。 回调的形式如下：

function ($path)

其中 $path 资源路径。请注意，$path 可以是资源目录，也可以是单个文件。 对于在 url() 中使用的相对路径的 CSS 文件， 哈希实现应该使用文件的目录路径而不是复制中的资源文件的相对路径。

如果未设置，资源管理器将在 hash 方法中使用 CRC32 和 filemtime。

用 MD4 哈希的一个实现例子：

function ($path) {
    return hash('md4', $path);
}

是否使用符号链接发布资源文件。默认为 false，意味着 资源文件件被复制到 $basePath。使用符号链接有这样的好处：发布的资源永远和 源文件一致，并且不需要复制操作。 这在开发过程中特别有用。

但是，使用符号链接对主机环境有特殊要求。 特别是，在 Linux/Unix，和 Windows Vista/2008 或更高版本上才支持符号链接。

此外，需要正确配置某些 Web 服务器，以便可以访问链接过的资源能被 Web 用户访问。 例如，对于 Apache Web 服务器，应添加以下的配置指令到 Web 文件夹：

Options FollowSymLinks