README

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

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

你喜欢这个插件吗？它的开发花了我很多时间。请考虑进行捐赠：一杯咖啡就足够了！谢谢。

安装

您可以通过 composer 安装此插件

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

然后您需要加载插件。有关如何加载插件的更多信息，请参阅食谱。

简单来说，您可以通过执行 shell 命令来启用插件

bin/cake plugin load Assets

这将更新您应用程序的引导方法。

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

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

如果您想使用不同的目录，请参阅配置部分。

最新的包和 master 分支至少需要 CakePHP 5.0 和 PHP 8.1，当前代码的开发基于这些版本以及更高版本的 CakePHP 和 PHP。但是，还有一些分支与之前版本的 CakePHP 和 PHP 兼容。

cakephp4 分支至少需要 PHP >=7.2 和 CakePHP ^4.0。

在这种情况下，您也可以安装此包

$ composer require --prefer-dist mirko-pagliai/cakephp-assets:dev-cakephp4

请注意，从 2024 年 1 月 5 日起，cakephp4 分支将不再更新，除非是安全补丁，它匹配 1.5.13 版本。

cakephp3 分支至少需要 PHP 5.6 和 CakePHP 3。

在这种情况下，您也可以安装此包

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

请注意，从 2021 年 4 月 27 日起，cakephp3 分支将不再更新，除非是安全补丁，它匹配 1.5.4 版本。

插件使用一些配置参数，您可以使用 \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() 方法。

请参阅我们的 API。

为了透明度和对发布周期的深入了解，同时保持向后兼容性，cakephp-assets 将根据语义化版本控制指南进行维护。