AnQiCMS 在模板中提供了功能丰富的过滤器，用于对数据进行处理和展示，其中 contain 过滤器便是经常用于判断内容是否包含特定关键词的实用工具。在使用这类过滤器时，我们经常会遇到关于大小写敏感性的问题，这直接关系到搜索和过滤结果的准确性。

认识 contain 过滤器及其基础用法

contain 过滤器在安企CMS模板中扮演着“内容检测器”的角色，它能够判断一个字符串、数组、键值对（map）或结构体（struct）中是否包含某个特定的关键词，并返回一个布尔值（True 或 False）。它的语法简洁明了：

{{ obj|contain:关键词 }}

例如，如果我们想检查一段文字中是否含有“CMS”：

{% set content = "欢迎使用安企CMS（AnQiCMS）" %}
{% if content|contain:"CMS" %}
    <p>内容中包含 "CMS"</p>
{% else %}
    <p>内容中不包含 "CMS"</p>
{% endif %}

这段代码会输出“内容中包含 “CMS””，因为字符串 content 里确实有 “CMS” 这个子串。

contain 过滤器不仅限于字符串，它还能应用于其他数据类型：

  • 判断数组中是否存在某个值： 
    
{% set tags = ["安企CMS", "AnQiCMS", "内容管理系统"] %}
{% if tags|contain:"AnQiCMS" %}
    <p>数组中包含 "AnQiCMS"</p>
{% endif %}
  • 判断键值对（map）或结构体（struct）中是否存在某个键名： 
    
{% set productInfo = {"Title":"安企CMS产品", "SKU":"AQ-CMS-001"} %}
{% if productInfo|contain:"Title" %}
    <p>产品信息中包含 "Title" 键名</p>
{% endif %}

深入探讨：大小写敏感性

当我们使用 contain 过滤器进行关键词匹配时，一个核心问题是它如何处理大小写。根据安企CMS模板过滤器的常规行为和文档描述，contain 过滤器在默认情况下是大小写敏感的。

这意味着，”CMS” 和 “cms” 在 contain 过滤器看来是两个完全不同的字符串。如果你的原文是 “AnQiCMS”，而你尝试用 contain:"cms" 去匹配，那么结果会是 False。

例如：

{% set source_text = "欢迎使用AnQiCMS内容管理系统" %}
{% if source_text|contain:"cms" %}
    <p>找到关键词 "cms" (大小写敏感)</p>
{% else %}
    <p>未找到关键词 "cms" (大小写敏感)</p>
{% endif %}

这段代码将输出“未找到关键词 “cms” (大小写敏感)”，因为 source_text 中并没有小写的 “cms”，只有大写的 “CMS”。

目前来看，安企CMS的模板系统，contain 过滤器没有提供直接的参数或配置选项来切换其大小写敏感性。这意味着我们不能像某些编程语言那样，通过一个 ignoreCase 参数直接告诉过滤器忽略大小写。

灵活应对：实现大小写不敏感的搜索

尽管 contain 过滤器本身不提供直接的大小写不敏感配置，但我们可以通过结合其他模板过滤器，巧妙地实现这一目标。最常用的方法是在进行 contain 判断之前，将源字符串和待匹配的关键词都统一转换为相同的大小写（通常是小写）。

安企CMS模板内置了 lower 过滤器，可以将英文字符串中的所有字母转换为小写。我们只需在 contain 之前应用 lower 过滤器即可：

{% set source_text = "欢迎使用AnQiCMS内容管理系统" %}
{% set search_keyword = "cms" %}

{# 将源文本和搜索关键词都转换为小写，然后再进行匹配 #}
{% if source_text|lower|contain:search_keyword|lower %}
    <p>内容包含关键词 "{{ search_keyword }}"（大小写不敏感）</p>
{% else %}
    <p>内容不包含关键词 "{{ search_keyword }}"（大小写不敏感）</p>
{% endif %}

运行这段代码，它会输出“内容包含关键词 “cms”（大小写不敏感）”，因为 “AnQiCMS” 被转换为 “anqicms”，”cms” 仍然是 “cms”，两者进行匹配就能成功。

这种方法的优点是简单、高效，且完全在模板层面实现，无需修改后端代码。

应用场景与实践建议

  • 需要大小写敏感的场景： 当你需要精确匹配，例如根据产品 SKU（库存单位）、用户 ID、特定的代码或缩写时，contain 过滤器默认的大小写敏感行为非常有用。这有助于确保数据的严谨性和唯一性。

  • 需要大小写不敏感的场景： 在处理用户输入的搜索查询、文章标签、评论内容或任何可能包含用户随意输入大小写的内容时，通常需要进行大小写不敏感的匹配。例如，用户搜索“营销策略”，希望也能匹配到“营销策略”或“营销策略”，此时统一转换为小写再匹配的方法就显得尤为重要。

总之，安企CMS的 contain 过滤器在默认情况下是大小写敏感的，虽然不直接提供大小写不敏感的配置选项，但通过灵活运用 lower（或 upper）等大小写转换过滤器，我们可以轻松实现大小写不敏感的关键词匹配，从而满足不同场景下的内容筛选需求。

常见问题 (FAQ)

1. contain 过滤器能否识别中文的大小写？ 在中文语境中，汉字本身没有像英文字母那样的大小写之分。因此，contain 过滤器在处理包含中文的字符串时，只进行字符层面的精确匹配，不涉及大小写转换。例如，"你好世界"|contain:"世界" 会是 True，而 lower 或 upper 过滤器对汉字通常没有效果。

2. 如果我需要模糊匹配（例如匹配部分单词），contain 过滤器适用吗？ contain 过滤器进行的是精确的子字符串匹配。它会查找关键词是否作为一个连续的序列存在于目标字符串中。如果你需要更复杂的模糊匹配（例如，基于编辑距离、语义相似度等），contain 过滤器本身无法满足，这通常需要通过后端代码或集成更高级的搜索功能来实现。

3. contain 过滤器是否支持正则表达式进行更复杂的匹配？ 安企CMS模板的 contain 过滤器目前不直接支持正则表达式作为匹配模式。它仅接受普通字符串作为关键词进行字面匹配。如果需要基于正则表达式进行内容匹配，可能需要在后端控制器层进行数据预处理，或者考虑其他提供正则表达式匹配能力的自定义标签或过滤器。