Django-Oscar项目集成Solr搜索引擎配置指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00615/article/details/148467698

Django-Oscar项目集成Solr搜索引擎配置指南

django-oscar django-oscar/django-oscar: 是一个基于 Django 的电子商务框架，可以用于快速开发和部署电子商务网站，提供了多种电子商务功能和插件扩展。项目地址: https://gitcode.com/gh_mirrors/dj/django-oscar

前言

在电子商务网站开发中，高效的搜索功能至关重要。Django-Oscar作为一款优秀的电子商务框架，推荐使用Apache Solr作为生产环境下的搜索引擎解决方案。本文将详细介绍如何在Django-Oscar项目中配置和使用Solr搜索引擎。

环境准备

系统要求

操作系统：基于Debian/Ubuntu的系统（其他Linux发行版也可参考）
Java环境：需要安装Java 8或OpenJDK 8
Python环境：已安装Django和Django-Oscar

Python依赖包

首先需要安装pysolr包，这是Python与Solr交互的客户端库：

pip install pysolr

建议将这一依赖添加到项目的requirements.txt文件中以便于管理。

Solr安装与配置

下载与安装

推荐使用Solr 6.6.6版本，这是经过Django-Oscar测试验证的稳定版本：

wget -O ${HOME}/solr-6.6.6.tgz https://archive.apache.org/dist/lucene/solr/6.6.6/solr-6.6.6.tgz
tar xzf ${HOME}/solr-6.6.6.tgz --directory=${HOME}
ln -s ${HOME}/solr-6.6.6 ${HOME}/solr

生产环境建议：开发环境可将Solr安装在用户主目录下，生产环境建议安装在/opt目录下。

启动Solr并创建核心

Solr使用"核心(core)"的概念来组织索引数据。我们创建一个名为sandbox的核心：

cd ${HOME}/solr
./bin/solr start
./bin/solr create -c sandbox -n basic_config

命名建议：可根据实际项目需求将sandbox替换为更有意义的名称。

Django-Oscar集成配置

Haystack连接设置

Haystack是Django的搜索抽象层，需要在settings.py中配置Solr连接：

HAYSTACK_CONNECTIONS = {
    'default': {
        'ENGINE': 'haystack.backends.solr_backend.SolrEngine',
        'URL': 'http://127.0.0.1:8983/solr/sandbox',
        'ADMIN_URL': 'http://127.0.0.1:8983/solr/admin/cores',
        'INCLUDE_SPELLING': True,
    },
}

生成Solr Schema

Django-Oscar提供了生成Solr schema的工具：

./manage.py build_solr_schema --configure-directory=${HOME}/solr/server/solr/sandbox/conf
./manage.py build_solr_schema --reload-core sandbox

重建索引

完成上述配置后，需要重建搜索索引：

./manage.py rebuild_index --noinput

如果一切正常，终端会显示索引的产品数量，此时网站的搜索功能应该已经可用。

高级配置：自定义产品属性与分面搜索

扩展搜索索引

要为产品添加自定义属性（如格式、颜色等）到搜索功能中，需要扩展Oscar的搜索应用：

派生搜索应用：

./manage.py fork_app search <your_app_name>
touch <your_app_name>/search/search_indexes.py

编辑search_indexes.py，继承并扩展Oscar的ProductIndex：

from oscar.apps.search import ProductIndex as OscarProductIndex
from haystack import indexes

class ProductIndex(OscarProductIndex):
    format = indexes.CharField(null=True, faceted=True)
    color = indexes.CharField(null=True, faceted=True)

    def prepare_format(self, obj):
        return obj.attribute_values.get(attribute__code="format").value_text

    def prepare_color(self, obj):
        return obj.attribute_values.get(attribute__code="color").value_text

更新Solr Schema

在schema.xml中添加对应的字段定义：

<field name="format" type="text" indexed="true" stored="true" multiValued="false" />
<field name="format_exact" type="string" indexed="true" stored="true" multiValued="false" />

<field name="color" type="text" indexed="true" stored="true" multiValued="false" />
<field name="color_exact" type="string" indexed="true" stored="true" multiValued="false" />

重新加载配置并重建索引

curl http://localhost:8983/solr/admin/cores?action=RELOAD&core=sandbox
cd ${HOME}/solr
./bin/solr restart
cd <path_to_your_app>
./manage.py rebuild_index --noinput

配置分面搜索

最后，在settings.py中添加分面搜索配置：

OSCAR_SEARCH_FACETS = {
    "fields": OrderedDict(
        [
            # 其他字段...
            ("format", {"name": "Format", "field": "format"}),
            ("color", {"name": "Color", "field": "color"}),
        ],
    ),
    # 其他配置...
}

完成以上步骤后，新的分面搜索字段将自动出现在网站搜索界面的左侧分类树下方。