PHPackages                             vladan-me/fingerprint-elasticsearch - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Search & Filtering](/categories/search)
4. /
5. vladan-me/fingerprint-elasticsearch

ActiveLibrary[Search & Filtering](/categories/search)

vladan-me/fingerprint-elasticsearch
===================================

Specifies advanced fingerprint analyzer for Elasticsearch index

1.2.1(8y ago)226MITPHPPHP >=5.4.0

Since Nov 24Pushed 8y ago1 watchersCompare

[ Source](https://github.com/vladan-me/fingerprint-elasticsearch)[ Packagist](https://packagist.org/packages/vladan-me/fingerprint-elasticsearch)[ RSS](/packages/vladan-me-fingerprint-elasticsearch/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (2)Versions (6)Used By (0)

Fingerprint Elasticsearch
=========================

[](#fingerprint-elasticsearch)

This is a package that prepares Elasticsearch analyzers, filters and tokenizers to work with custom implementation of fingerprint algorithm. It is basically an improved version of [fingerprint - official Elasticsearch documentation](https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-fingerprint-analyzer.html)The difference is that custom analyzer that is created includes synonyms filter making the final combination something like this:

- lowercase
- asciifolding
- fp\_X\_syn (synonyms for specific type X)
- fp\_X\_rem (removals for specific type X)
- fingerprint

Available types are City, Company, Street and Title. That means, whenever you need to store cities, companies, street addresses or titles you likely need this analyzer that will help you sort them out. Otherwise, you'll end up with messy data.

Use cases
---------

[](#use-cases)

- Having complete Elasticsearch fingerprint analyzer
- Combined with [fingerprint](https://www.github.com/vladan-me/fingerprint)makes creation and testing fingerprint easier.

Documentation
-------------

[](#documentation)

City analyzer/filter/property can be get like this:

```
        $ESCity = new ESCity();

        $analyzer = $ESCity->analyzerES();
        $filter = $ESCity->filterES();
        $prop = $ESCity->propES();
```

That creates analyzer with specific filters:

```
   'fp_city_analyzer' => [
       'type'      => 'custom',
       'tokenizer' => 'standard',
       'filter'    => [
           'lowercase',
           'asciifolding',
           'fp_city_syn',
           'fp_city_rem',
           'fingerprint',
       ],
   ]
```

It is using same synonyms and removals from depending project.

And specific city property:

```
   'type'         => 'keyword',
   'ignore_above' => 256,
   'fields'       => [
       'fp' => [
           'type'     => 'text',
           'analyzer' => 'fp_city_analyzer',
       ],
```

Please look at tests for more examples.

System Requirements
-------------------

[](#system-requirements)

You need **PHP >= 5.4.0**. Even though there's no Elasticsearch dependency, fingerprint token filter is available from Elasticsearch version 5.0 Depending on [fingerprint](https://www.github.com/vladan-me/fingerprint) for synonyms/removals.

Install
-------

[](#install)

Install `fingerprint-elasticsearch` using Composer.

```
$ composer require vladan-me/fingerprint-elasticsearch

```

Additional Notes
----------------

[](#additional-notes)

This package contains additional analyzers (punctuation removal, 2gram and 3gram with punctuation) that might be useful depending on use case, but likely should be optional.

Contributing
------------

[](#contributing)

Contributions are welcome and will be fully credited. Please see [CONTRIBUTING](.github/CONTRIBUTING.md) and [CONDUCT](CONDUCT.md) for details.

License
-------

[](#license)

The MIT License (MIT). Please see [LICENSE](LICENSE) for more information.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

5

Last Release

3090d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8fa0c910c52a41647446049ef065fab1a563d859d8c2a688eec79ff0099a57cb?d=identicon)[vladan-me](/maintainers/vladan-me)

---

Top Contributors

[![vladan-me](https://avatars.githubusercontent.com/u/6961430?v=4)](https://github.com/vladan-me "vladan-me (10 commits)")

---

Tags

elasticsearchFingerprintngram

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/vladan-me-fingerprint-elasticsearch/health.svg)

```
[![Health](https://phpackages.com/badges/vladan-me-fingerprint-elasticsearch/health.svg)](https://phpackages.com/packages/vladan-me-fingerprint-elasticsearch)
```

###  Alternatives

[elasticsearch/elasticsearch

PHP Client for Elasticsearch

5.3k178.3M943](/packages/elasticsearch-elasticsearch)[matchish/laravel-scout-elasticsearch

Search among multiple models with ElasticSearch and Laravel Scout

7431.6M2](/packages/matchish-laravel-scout-elasticsearch)[opensearch-project/opensearch-php

PHP Client for OpenSearch

15024.3M65](/packages/opensearch-project-opensearch-php)[mailerlite/laravel-elasticsearch

An easy way to use the official PHP ElasticSearch client in your Laravel applications.

934529.3k2](/packages/mailerlite-laravel-elasticsearch)[babenkoivan/elastic-scout-driver

Elasticsearch driver for Laravel Scout

2773.8M5](/packages/babenkoivan-elastic-scout-driver)[babenkoivan/elastic-scout-driver-plus

Extension for Elastic Scout Driver

2862.8M1](/packages/babenkoivan-elastic-scout-driver-plus)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)