README

cakephp-assets 是一个 CakePHP 插件，允许您处理和生成资产。

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

• 安装
• 配置
  • 配置值
• 如何使用
• 版本控制

安装

您可以通过 composer 安装此插件

$ composer require --prefer-dist jeffersonsimaongoncalves/cakephp-assets

注意：最新版本至少需要 CakePHP 3.7.

相反，cakephp3.2 分支与所有之前的 CakePHP 版本（从 3.2.4 版本开始）兼容。
此分支与 cakephp-assets 的 1.4 版本相对应，并且无论如何，它将不再接收新功能，只修复错误。

在这种情况下，您也可以安装该软件包

$ composer require --prefer-dist jeffersonsimaongoncalves/cakephp-assets:dev-cakephp3.2

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

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

有关如何加载插件的其他信息，请参阅Cookbook。

默认情况下，插件使用 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() 方法。

版本控制

为了透明度和对发布周期的深入了解，以及为了维护向后兼容性，cakephp-assets 将按照 语义化版本控制指南 进行维护。

致谢

此作品基于 Mirko Pagliai 的 代码。