文件Commerce設定指南

設定搜尋停用詞

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 經驗豐富
  • 管理員
  • 開發人員

一般而言，停用詞 ​是搜尋引擎在處理文字後篩選掉的常用詞。 最初，當磁碟空間和記憶體極為有限時，每儲存KB意味著效能大幅提升。 因此，搜尋引擎透過忽略特定字詞並維持較小的索引來提升效能。

雖然我們目前擁有更多儲存空間，但效能仍然很重要。 Elasticsearch和OpenSearch就像其他搜尋引擎一樣，仍使用停用字詞來改善效能。

您必須使用位於<magento_root>/vendor/magento/module-elasticsearch/etc/stopwords目錄或<magento_root>/app/code/Magento/Elasticsearch/etc/stopwords/目錄中的CSV檔案來管理您的停用詞，這取決於您安裝Commerce軟體的方式。

如需Elasticsearch和OpenSearch如何使用停用字詞的詳細資訊，請參閱下列資源：

設定停用詞

停用字詞位於<magento_root>/vendor/magento/module-elasticsearch/etc/stopwords目錄中。 Adobe Commerce隨附一個CSV檔案，其中包含預設地區設定的停用詞，以及另一個檔案stopwords.csv，其中包含其他CSV檔案未表示的任何地區設定的停用詞。

停用字檔案快取的預設存留期為15分鐘。

編輯現有地區設定的停用詞

若要編輯停用詞：

  1. 登入您的Commerce伺服器，或切換至檔案系統擁有者。

  2. 使用文字編輯器在<magento_root>/vendor/magento/module-elasticsearch/etc/stopwords目錄中開啟停用字檔案。

    CSV檔案使用命名慣例stopwords_<locale_code>.csv。 例如，德文的Stopword檔案名為stopwords_de_DE.csv。

  3. 在檔案中新增單字、移除單字或變更單字。

    （檔案中的每個停用字都會從新行開始。）

  4. 儲存變更並退出文字編輯器。

  5. 清除設定快取。

    • 管理員： 系統 >工具> 快取管理。 選取「組態」核取方塊，並從上方清單按一下「重新整理」。 按一下​ 提交 ​以完成動作。

    • 命令列：以檔案系統擁有者的身分，輸入下列命令：

      code language-bash 
      php <magento_root>/bin/magento cache:clean config

  6. 在您的店面搜尋字詞，以檢查結果。

為新地區設定建立停用詞

若要為地區設定 ​新增停用詞：

  1. 登入您的Commerce伺服器，或切換至檔案系統擁有者。

  2. 使用文字編輯器在<magento_root>/vendor/magento/module-elasticsearch/etc/stopwords目錄中建立名為stopwords_<locale_code>.csv的停用字檔案。

    例如，若要為義大利語言環境建立停用詞，請將檔案命名為stopwords_it_IT.csv。

  3. 在您的停用字檔案中，確定每個停用字都位於不同的行上。

  4. 儲存變更並退出文字編輯器。

  5. 在相同目錄中，在文字編輯器中開啟esconfig.xml。

  6. 新增一行到esconfig.xml，如下所示：

    code language-xml 
    <LOCALE_CODE>stopwords_LOCALE_CODE.csv</LOCALE_CODE>

    例如，若要新增義大利停用字檔案，請新增下列行：

    code language-xml 
    <it_IT>stopwords_it_IT.csv</it_IT>

  7. 將變更儲存至esconfig.xml並結束文字編輯器。

  8. 清除設定快取。

    • 管理員： 系統 >工具> 快取管理。 選取「組態」核取方塊，並從上方清單按一下「重新整理」。 按一下​ 提交 ​以完成動作。

    • 命令列：以檔案系統擁有者的身分，輸入下列命令：

      code language-bash 
      php <magento_root>/bin/magento magento cache:clean config

  9. 在您的店面搜尋字詞，以檢查結果。

變更停用字目錄

本節討論如何選擇性地從下列其中一項變更預設停用字目錄：

  • <magento_root>/vendor/magento/module-elasticsearch/etc/stopwords
  • <magento_root>/app/code/Magento/Elasticsearch/etc/stopwords/

此位置視您安裝Commerce軟體的方式而定。 如果您複製Magento2 GitHub存放庫，則路徑位於app/code下。 如果您已安裝壓縮封存或中繼資料，則路徑在vendor之下。

若要變更目錄：

  1. 以檔案系統擁有者的身分，在文字編輯器中開啟Elasticsearchdi.xml。

    如果您複製存放庫，則它位於app/code/Magento/Elasticsearch/etc/di.xml

    如果您有封存或中繼資料，則位於vendor/magento/module-elasticsearch/etc/di.xml

  2. 將stopwordsDirectory的值變更為所要的目錄：

    code language-xml 
    <type name="Magento\Elasticsearch\SearchAdapter\Query\Preprocessor\Stopwords">
    <arguments>
        <argument name="stopwordsDirectory" xsi:type="string">app/code/Magento/Elasticsearch/etc/stopwords</argument>
    </arguments>
</type>

  3. 將變更儲存至di.xml並結束文字編輯器。

若要從模組變更目錄

  1. 建立模組

  2. 在您的模組etc/di.xml中新增指示：

    code language-xml 
    <type name="Magento\Elasticsearch\SearchAdapter\Query\Preprocessor\Stopwords">
    <arguments>
       <argument name="stopwordsModule" xsi:type="string">Your_Module</argument>
       <argument name="stopwordsDirectory" xsi:type="string">stopwords</argument>
    </arguments>
</type>

  3. 在您的模組中，使用對應的CSV檔案建立目錄etc/stopwords。

  4. 將變更儲存至di.xml並結束文字編輯器。

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c