README

SS-image-min 是一个基于 nielse63/php-image-cache 的 Silverstripe 模块，用于图像压缩和服务器端缓存。

要求

SilverStripe 框架 3.0+

安装

通过以下任何方法安装模块后，您必须通过访问 http://yoursite.com/dev/build 来构建您的数据库。

Composer

创建一个 composer.json 文件

    {
        "require" : {
            "encoda/ss-image-min": "~0.1.3"
        }
    }

转到您的项目根目录并运行安装命令。

$ composer install

Github

转到您的 SilverStripe 应用程序根目录并执行 git clone https://github.com/encoda/ss-image-min.git

手动

下载 此 zip 文件 并将其提取到您的 SilverStripe 根目录中。

使用

一旦安装了该模块，每次在数据库中保存时，都会自动为每个 Silverstripe Image 实例文件生成一个压缩缓存版本，或者（如果该模块最近安装在应用程序中并且数据库中已经有几个图像）在直接或间接调用其中任何一个的 URL 时，通过调用以下方法之一生成： getTag、getUrl 或 getAbsoluteURL。

示例

mysite/code/NarcissisticTeenager.php

<?php

NarcissisticTeenager extends DataObject {
    ...
    private static $many_many = array(
        'Selfies' => 'Image',
    );

    public function FirstSelfie() {
        return $this->Selfies()->First();
    }
    ...
}

themes/autinpack/templates/Page.ss

<% with $SomeNarcissisticTeenager %>
    <% loop $Selfies %>
        $GetTag
    <% end_loop %>
<% end_with %>

配置

SS-image-min 不需要任何配置。尽管您可以通过 _config.php 覆盖其中一些设置。

压缩率

默认值: 80

<?php

SSImageCache::$compress_rate = 70;

增加内存限制

生成压缩图像需要比 PHP 通常允许使用更多的内存。因此，默认情况下，SS-image-min 在压缩过程中临时增加其内存限制。

默认值: '2480M'

<?php

SSImageCache::$increased_memory_limit = '128M';

缓存图像目录

更改保存生成的缓存图像的目录。

默认值: 'ASSETS_PATH . /cache/images'

<?php

SSImageCache::$image_directory = '/home/user/workspace/project/assets/cached_images';

重要: 选择的目录必须具有写入权限。

许可证 (MIT)

软件按“原样”提供，不提供任何形式的保证，明示或暗示，包括但不限于适销性、特定用途适用性和非侵权性保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任承担责任，无论源于合同、侵权或其他方式，与软件或其使用或其他交易有关。