README

Elasticsearch 扩展包是为了满足专业级 Elasticsearch 与企业级 Symfony 应用集成的需求而创建的。本扩展包是

• 使用官方的 elasticsearch-php 客户端。
• 确保完全与 Symfony 框架和 Symfony Flex 集成。

技术亮点

• 提供了一种 DSL 查询构建器，以目标方式表示所有 ElasticSearch 端点。
• 通过 CLI 命令（ongr:es:document:generate）提供交互式文档对象生成器。
• 使用注解创建了一种类似于 Doctrine 的方式来处理文档（实体）文档对象映射。
• 提供几个查询结果迭代器，方便您处理结果。
• 提供索引管理和数据导入/导出/重新索引的 Console CLI 命令。
• 分析器与 Symfony 调试栏集成，并显示所有执行的查询。
• 设计得非常灵活，以满足您的所有定制需求。
• 支持 Symfony FLEX。

如果您需要任何帮助，请通过 stack overflow 获取答案。这是询问有关 ONGR 扩展包和库的最佳和推荐方式。

如果您喜欢这个库，请通过购买一杯咖啡帮助我开发它

版本矩阵

文档

本扩展包的在线文档可以在 http://docs.ongr.io 找到。文档源存储在存储库中的 Resources/doc/ 目录下，因此如果您发现任何错误或不准确之处，请提交一个 PR 或至少提交一个 issue 来修复它！

有关对文档的贡献，您可以在 contribute 主题中找到。

常见问题解答

• 索引映射
• 配置
• Console 命令
• 如何进行简单的 CRUD 操作
• 快速查找功能
• 如何在索引中执行搜索
• 解析结果

设置扩展包

第 1 步：安装 Elasticsearch 扩展包

Elasticsearch 扩展包使用 Composer 安装。

php composer.phar require ongr/elasticsearch-bundle "~6.0"

有关安装和部署 Elasticsearch 的说明，请参阅 Elasticsearch 安装页面。

在您的 AppKernel 中启用 ElasticSearch 扩展包

<?php
// config/bundles.php

return [
    // ...
    ONGR\ElasticsearchBundle\ONGRElasticsearchBundle::class => ['all' => true],
];

(可选) 第 2 步：添加配置

添加 Elasticsearch 扩展包的最小配置。

# config/packages/ongr_elasticsearch.yaml
ongr_elasticsearch:
    analysis:
        filter:
            edge_ngram_filter: #-> your custom filter name to use in the analyzer below
                type: edge_ngram 
                min_gram: 1
                max_gram: 20
        analyzer:
            eNgramAnalyzer: #-> analyzer name to use in the document field
                type: custom
                tokenizer: standard
                filter:
                    - lowercase
                    - edge_ngram_filter #that's the filter defined earlier
    indexes:
        App\Document\Product:
            hosts: [elasticsearch:9200] # optional, the default is 127.0.0.1:9200

这是一个非常基本的示例，有关更多信息，请参阅 配置章节。

第 3 步：将您的 Elasticsearch 类型定义为 Document 对象

本扩展包使用对象来表示 Elasticsearch 文档。让我们为 products 索引创建一个 Product 类。

// src/Document/Product.php

namespace App\Document;

use ONGR\ElasticsearchBundle\Annotation as ES;

/**
 * //alias and default parameters in the annotation are optional. 
 * @ES\Index(alias="products", default=true)
 */
class Product
{
    /**
     * @ES\Id()
     */
    public $id;

    /**
     * @ES\Property(type="text", analyzer="eNgramAnalyzer")
     */
    public $title;

    /**
     * @ES\Property(type="float")
     */
    public $price;
}

这是一个非常基本的示例，有关映射的更多信息，请参阅 映射章节。

第 4 步：创建索引和映射

Elasticsearch 扩展包提供了一些 CLI 命令。其中之一是用于创建索引，请在您的终端中运行该命令

bin/console ongr:es:index:create

现在应该使用您的文档中的字段来创建products索引。

关于其他命令的更多信息，可以在命令章节中找到。

步骤 5：享受使用 Elasticsearch 的过程。

Elasticsearch 扩展包的完整文档在这里提供。希望您能用它创造出令人惊叹的东西 😎。

请注意，该扩展包文档更新到 6.0 的过程仍在进行中。请阅读已经更新的配置和CRUD部分，这将允许您使用扩展包的基本功能。我们将尽快更新其余的文档。

故障排除

• 如何升级到旧版本？
• 如何覆盖扩展包的一些部分？

许可证

此扩展包根据MIT许可证授权。请参阅扩展包中的完整LICENSE文件。