应用程序/配置/ config.yml),是由一组过滤器,后处理器,和其他可选参数。

我们将了解更多关于后处理器和其他可用的参数之后,但现在让专注于如何定义一组小过滤器由几个过滤器。

数据加载器和cache-resolvers正确操作。使用以下配置样板。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

# app / config / config.ymlliip_imagine:#配置解析器解析器:#设置默认解析器默认值:#使用默认的网络路径web_path:~#你的过滤器定义集filter_sets:#使用默认缓存配置缓存:~

基本配置到位,我们将从一个示例开始,实现一个共同的用例:创建缩略图。让我们假设我们想要得到的缩略图有以下转换应用于:

• 规模和作物图像120 x90px。
• 添加一个2 px黑色边框的图像。
• 调整图像质量为75。

从上面添加到我们的样板,我们需要定义一个过滤器组(我们的名字my_thumb)与两个过滤器配置:缩略图和背景过滤器。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21日22日23日24日25日26日

# app / config / config.ymlliip_imagine:解析器:默认值:web_path:~filter_sets:缓存:~#“过滤器”的名称my_thumb:#调整图像质量的75%质量:75年#转换应用列表(“过滤器”)过滤器:#创建一个缩略图:大小设置为120 x90并使用“出站”模式#作物图像输入不同的大小比例缩略图:{大小:(120年,90年),模式:出站}#创建一个2 px黑色边框:中心黑色背景上的缩略图# 4 px大创建一个2 px边框最终的图像背景:{大小:(124年,94年),位置:中心,颜色:# 000000的}

您现在已经创建了一个过滤器设置my_thumb执行一个缩略图变换。的缩略图过滤器尺寸图像所需的宽度和高度(120 x90px),和它的模式:出站选择使生成图像裁剪如果输入比例不同。的背景过滤结果在2 px黑色边框通过创建一个黑色帆布124 x94px大小,和定位缩略图的中心。

请注意

定义一组滤波器可以拥有任意数量的过滤器。简单的转换可能只需要一个过滤器,而更复杂的转换可以拥有任意数量的过滤器定义。

有许多额外的过滤器,但是现在你可以用你的新定义my_thumb滤波器组立即在一个模板。

• 嫩枝
• PHP

1

<imgsrc=”{{资产(“/亲戚/道路/ / image.jpg”) | imagine_filter (my_thumb)}}”/ >

1

<imgsrc=“< ?(想象的)php echo $ this - >过滤器(“/亲戚/道路/ / image.jpg”、“my_thumb”) ? > "/ >

在幕后,包过滤器(s)适用于图像动态当第一个页面请求。转换后的图像然后为后续请求缓存。最后一个缓存图像路径将类似/媒体/缓存/ / / image.jpg my_thumb /相对路径。

提示

你可以提前准备缓存的命令或者是消息队列,或处理与web服务器配置丢失的文件。当你这样做,你可以使用imagine_filter_cache缓存过滤总是返回一个链接到最终图像。

请注意

当你使用资产函数来解决图像路径和资产版本化配置imagine_filter试图处理版本查询字符串。看到资产版本化为更多的信息。

请注意

使用dev环境中,您可能会发现,通过模板辅助图片不正确呈现。这通常是通过引起的intercept_redirect在应用程序中启用配置。为了确保画面渲染,强烈建议禁用这个选项:

1 2 3 4

# app / config / config_dev.ymlweb_profiler:intercept_redirects:假

• 嫩枝
• PHP

1 2 3

{%集runtimeConfig ={“缩略图”:{“大小”:[50,50]}}%}<imgsrc=”{{资产(“/亲戚/道路/ / image.jpg”) | imagine_filter (my_thumb, runtimeConfig)}}”/ >

1 2 3 4 5 6 7 8 9

< ? php美元runtimeConfig= (“缩略图”= > [“大小”= > [50,50]]];? ><imgsrc=“< ?php $这(想象的)- >过滤器(' /相对路径/ / image.jpg’,‘my_thumb’, runtimeConfig美元)? > "/ >

liip:想象:缓存:决心。唯一需要的参数是一个或多个图像相对路径(必须用空格分隔)。

1

美元php bin /控制台liip:想象:缓存:解决相对路径/ / image1.jpg相对路径/ / image2.jpg

此外,您可以使用——过滤器选项来指定哪个过滤器(如果你想要解决——过滤器选择是省略了,所有可用的过滤器将解决)。

1

美元php bin /控制台liip:想象:缓存:解决相对路径/ / = my_thumb image1.jpg——过滤器

getBrowserPath的方法liip_imagine.cache.manager服务。假设你已经服务分配给一个变量imagineCacheManager美元,你会:

1

美元imagineCacheManager- >getBrowserPath (“相对路径/ / image.jpg”,“my_thumb”);

通常,您需要执行这个操作在一个控制器。

您可以访问缓存管理器仅仅通过类型提示它在你的控制器方法:服务liip_imagine.cache.manager将自动注入和你能电话吗getBrowserPath相对图像路径解决位置。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

< ? php名称空间应用程序\控制器;使用\Liip\ImagineBundle\想象一下\缓存\缓存管理器;类YourController{公共函数yourControllerMethod(缓存管理器美元imagineCacheManager){/ * *@var字符串* /美元resolvedPath=美元imagineCacheManager- >getBrowserPath (“相对路径/ / image.jpg”,“my_thumb”);/ /……}}