README

自2018年4月起，此仓库已被废弃。
请参阅： cakephp-assets。

资产插件

Assets是一个允许您处理和生成资产的CakePHP插件。

它使用matthiasmullie/minify并提供了一个方便的辅助函数，允许您将多个资产文件合并成一个单一的压缩文件。

您可以通过composer安装插件

$ composer require --prefer-dist mirko-pagliai/assets

注意：该包可能需要最新版本的CakePHP。
相反，cakephp3.2分支与从3.2版本开始的CakePHP版本兼容。
在这种情况下，您也可以安装该包

$ composer require --prefer-dist mirko-pagliai/assets:dev-cakephp3.2

安装后，您必须编辑APP/config/bootstrap.php来加载插件

Plugin::load('Assets', ['bootstrap' => true, 'routes' => true]);

有关如何加载插件的信息，请参阅食谱。

默认情况下，插件使用APP/tmp/assets目录来保存资产文件。因此，您必须创建该目录并使其可写

$ mkdir tmp/assets && chmod 775 tmp/assets

如果您想使用不同的目录，请参阅以下内容。

插件使用一些配置参数，您可以使用\Cake\Core\Configure类设置它们，在加载插件之前。

例如，您可以在应用程序的文件APP/config/app.php的底部这样做。

Configure::write('Assets.force', false);

将Assets.force设置为true，即使启用调试，也将使用资产。

Configure::write('Assets.target', TMP . 'assets');

设置Assets.target，您可以指定插件生成资产的另一个目录。

您必须只使用AssetHelper。此辅助函数提供了与HtmlHelper提供的功能类似的css()和script()方法。

语法相同，只需更改辅助函数的名称。例如，对于AssetHelper::css()。

echo $this->Asset->css(['one.css', 'two.css']);

这将合并并压缩one.css和two.css文件，创建一个唯一的资产文件，并将创建一个链接元素，用于CSS样式表，就像HtmlHelper提供的方法一样。

同样也适用于AssetHelper::script()方法。

为了透明度和对发布周期的洞察，以及为了保持向后兼容性，Assets将按照语义版本控制指南进行维护。