文件Commerce設定指南

設定搜尋停用詞

Last update: Tue Apr 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Experienced
  • Admin
  • Developer

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

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

您必須使用位於以下位置的CSV檔案來管理您的停用詞： <magento_root>/vendor/magento/module-elasticsearch/etc/stopwords 目錄或 <magento_root>/app/code/Magento/Elasticsearch/etc/stopwords/ 目錄，視您安裝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. 使用文字編輯器建立名為的停用字檔案 stopwords_<locale_code>.csv 在 <magento_root>/vendor/magento/module-elasticsearch/etc/stopwords 目錄。

    例如，若要為義大利語言環境建立停用詞，請為檔案命名 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. 以檔案系統擁有者的身分，開啟Elasticsearch di.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. 在您的模組中，建立目錄 etc/stopwords，並使用對應的CSV檔案。

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

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