用途:面向 Bitrix 框架的站点搜索模块(旧版 CSearch)技能资料,覆盖索引自建实体、重索引、搜索调用与引擎选择。基础要求:main 23.0+,实测 search 25.200.0、main 26.800.0;所有版本(站点管理与 Bitrix24)均自带。仅提供旧 API:CSearch* 类,无 lib/、无 D7 或 ORM 层、无控制台命令。
主要能力与阅读主题:rules/indexing.md 介绍索引自有实体、字段、权限、删除及 BeforeIndex;rules/reindex.md 介绍 OnReindex 处理器、全量/模块重索引、CLI 与步骤;rules/searching.md 介绍 search.page/search.title、CSearch::Search()、权限与 URL 钩子;rules/engines.md 介绍 Sphinx/OpenSearch/MySQL/PgSQL 引擎、词干处理、自定义排序与静态文件。
不变量与用法:调用任何 CSearch* 前先用 Loader::includeModule('search'),模块可能缺失或未安装,索引失败不得影响写入;将 CSearch 封装在 /local/modules/<vendor.module>/ 的单一服务中,实体事件与 OnReindex 处理器共用同一字段构造器;索引键为 (MODULE_ID, ITEM_ID),使用自己的模块 id,不用 iblock 或 main;始终传入 SITE_ID、PERMISSIONS、DATE_CHANGE,无权限项仅管理员可见,G2 表示包括匿名用户在内的所有人;用模块 id 在安装器中持久注册 search:OnReindex,不要用运行时 addEventHandler();网页上下文搜索时 CSearch::Search() 需要 $USER,在 agent 中会致命错误。
限制:仅旧版 API;未提供收费、价格、平台与效果等资料。