配置

编辑此页

该捆绑包的默认配置如下所示

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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
# app/config/config.yml
liip_imagine:

    resolvers:
        default:
            web_path:
                web_root: ~ # %kernel.project_dir%/public (%kernel.project_dir%/web for Symfony < 4.0.0)
                cache_prefix: ~ # media/cache

    loaders:
        default:
            filesystem:
                data_root: ~  # %kernel.project_dir%/public (%kernel.project_dir%/web for Symfony < 4.0.0)

    driver:               gd
    cache:                default
    data_loader:          default
    default_image:        null
    twig:
        mode:             legacy
    default_filter_set_settings:
        quality:              100
        jpeg_quality:         ~
        png_compression_level:  ~
        png_compression_filter: ~
        animated:             false
        format:               ~
        cache:                ~
        data_loader:          ~
        default_image:        null
        filters: []
        post_processors: []
    controller:
        filter_action:          liip_imagine.controller::filterAction
        filter_runtime_action:  liip_imagine.controller::filterRuntimeAction
        redirect_response_code: 302
    webp:
        generate:    false
        quality:     100
        cache:       ~
        data_loader: ~
        post_processors: []
    filter_sets:

        # Prototype
        name:
            quality:              100
            jpeg_quality:         ~
            png_compression_level:  ~
            png_compression_filter: ~
            animated:             false
            format:               ~
            cache:                ~
            data_loader:          ~
            default_image:        null
            filters:

                # Prototype
                name:                 []

            post_processors:

                # Prototype
                name:                 []

有几个可用的配置选项

  • cache - 默认缓存解析器。默认值：web_path（表示使用标准的 web_path 解析器）
  • data_loader - 自定义数据加载器的名称。默认值：filesystem（表示使用标准的文件系统加载器）。
  • twig.mode - Twig 过滤器集成。none 禁用 twig 过滤器，lazy 启用 Twig 使用 Twig 运行时进行延迟加载。默认值为 legacy，并启用在每个请求上加载的旧 Twig 集成。版本 3 将删除 legacy 并默认为 lazy。twig 过滤器自动拾取 framework.assets.version 配置。你可以使用 twig.assets_version 选项覆盖版本。有关更多信息，请参阅 资产版本控制。
  • 控制器
    • filter_action - 在路由加载器中使用的控制器操作的名称。默认值：liip_imagine.controller:filterAction
    • filter_runtime_action - 在路由加载器中用于 runtimeconfig 图像的控制器操作的名称。默认值：liip_imagine.controller:filterRuntimeAction
    • redirect_response_code - 从 imagine 控制器返回的 HTTP 重定向响应代码，可以是 201、301、302、303、307 或 308 之一。默认值：302。如果你想更改此配置，请参阅 避免不必要的重定向。
  • webp
    • generate - 启用以 WebP 格式生成图像副本。
    • quality - 覆盖过滤器选项的质量。
    • cache - 默认缓存解析器。默认值：web_path（表示使用标准的 web_path 解析器）
    • data_loader - 自定义数据加载器的名称。默认值：filesystem（表示使用标准的文件系统加载器）。
    • post_processors - 设置要应用于已过滤图像的后处理器（有关详细信息，请参阅过滤器章节中的后处理器部分）。
  • driver - 驱动程序之一：gd、imagick、gmagick、vips。默认值：gd * 如果你想使用 vips，你还需要额外 require rokka/imagine-vips
  • default_filter_set_settings - 指定将在 filter_sets 中定义的任何集合继承的默认值。如果在每个集合中指定了这些值，则将覆盖这些值。在 filters 和 post_processors 的情况下，指定的值将与默认值合并。
  • filter_sets - 指定你想定义和使用的过滤器集。

你指定的每个过滤器集都具有以下选项

  • filters - 确定要使用的过滤器类型（有关更多信息，请参阅过滤器部分）以及应传递给特定过滤器类型的选项。
  • post_processors - 设置要应用于已过滤图像的后处理器（有关详细信息，请参阅过滤器章节中的后处理器部分）。
  • jpeg_quality - 覆盖 jpeg 图像的质量（这会覆盖上面的 quality 选项）
  • png_compression_level - 设置 png 图像的压缩级别 (0-9)（这会覆盖上面的 quality 选项）
  • png_compression_filter - 设置 png 图像的压缩过滤器（有关更多详细信息，请参阅 PHP 手册中 imagepng 函数的 filters 参数）
  • cache - 覆盖默认缓存设置。
  • data_loader - 覆盖默认数据加载器。
  • route - 在路由加载器中使用的可选路由需求、默认值和选项列表。添加带有键 requirements、defaults 或 options 的数组。默认值：空数组。
  • format - 硬编码输出格式（这意味着请求的格式将被忽略）。
  • animated - 支持调整动画 gif 的大小（当前 Imagine 不支持（PR 待定））
这项工作，包括代码示例，根据 Creative Commons BY-SA 3.0 许可获得许可。
目录
    版本