README

Elasticsearch Bundle 的创建是为了满足在高级 Symfony 应用程序中专业集成 Elasticsearch 的需求。此扩展包包括

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

技术特性

• 提供了一种 DSL 查询构建器，以客观的方式表示所有 ElasticSearch 端点。
• 通过 CLI 命令（ongr:es:document:generate）提供交互式文档对象生成器。
• 创建了一种类似 Doctrine 的方式，使用注解来处理文档（实体）文档对象映射。
• 提供多个查询结果迭代器，方便您处理结果。
• 为索引管理、数据导入/导出/重新索引提供控制台 CLI 命令。
• Profiler 集成到 Symfony 调试栏中，显示所有执行的查询。
• 设计方式灵活，满足您的所有自定义需求。
• 支持 Symfony FLEX。

如果您需要任何帮助，Stack Overflow 是获取答案的首选方式。这是询问 ONGR 扩展包和库问题的首选和推荐方式。

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

版本矩阵

文档

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

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

常见问题解答

• 索引映射
• 配置
• 控制台命令
• 如何执行简单的 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文件。