PHPackages                             beta/faceted.search - 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. beta/faceted.search

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

beta/faceted.search
===================

Faceted search

1.4.1(2y ago)1265MITPHPPHP >=7.2

Since May 12Pushed 2y ago2 watchersCompare

[ Source](https://github.com/beta-eto-code/faceted.search)[ Packagist](https://packagist.org/packages/beta/faceted.search)[ RSS](/packages/beta-facetedsearch/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (7)Used By (0)

Фасетный поиск
==============

[](#фасетный-поиск)

**Пример создания фасетного индекса:**

```
use Faceted\Search\FacetBuilder;
use Data\Provider\Providers\PdoDataProvider;
use Data\Provider\SqlBuilderMySql;

$clothDataProvider = new PdoDataProvider(
    $someConnection,
    'cloth_table',
    new SqlBuilderMySql(),
    'id'
);
$clothFacetIndex = FacetBuilder::init($clothDataProvider)
    ->setItemIdKey('id')            // указываем первичный ключ записи
    ->registerProperty('gender')    // индексируем признак мужской и женской одежды
    ->registerProperty('size')      // индексируем размеры одежды
    ->registerProperty('color')     // индексируем цвет одежды
    ->registerProperty('type')      // индексируем категорию одежды
    ->setLimitByStepIndex(1000)     // указываем количество записией индексируемых за один шаг
    ->build();                      // запускаем сборку индекса
```

**Запись, чтение, удаление фасетного индекса:**

```
use Faceted\Search\FacetManger;
use Data\Provider\Providers\PdoDataProvider;
use Data\Provider\SqlBuilderMySql;

$facetDataProvider = new PdoDataProvider(
    $someConnection,
    'facet_index_table',
    new SqlBuilderMySql(),
    'id'
);
$manager = new FacetManger($facetDataProvider);
$manager->saveFacetById('cloth', $clothFacetIndex); // сохраняем фасетный индекс присвоив ему идентификатор cloth
$userFacetIndex = $manager->getFacetById('user');   // запрашиваем фасетный индекс сохраненный под идентификатором user
$manager->removeFacetById('other');                 // удаляем фасетный индекс с идентификатором other
```

**Работа с фасетным индексом**

```
use Faceted\Search\FacetManger;
use Data\Provider\Providers\PdoDataProvider;
use Data\Provider\SqlBuilderMySql;
use Data\Provider\QueryCriteria;
use Data\Provider\Interfaces\CompareRuleInterface;

$facetDataProvider = new PdoDataProvider(
    $someConnection,
    'facet_index_table',
    new SqlBuilderMySql(),
    'id'
);
$manager = new FacetManger($facetDataProvider);
$clothFacetIndex = $manager->getFacetById('cloth');
$clothFacetIndex->getValuesByProperty('color'); // запрашиваем список всех доступных цветов для одежды

$query = new QueryCriteria();
$query->addCriteria('color', CompareRuleInterface::IN, ['white', 'blue', 'red']);
$query->addCriteria('gender', CompareRuleInterface::IN, ['male', 'female']);
$query->addCriteria('size', CompareRuleInterface::EQUAL, 'M');
$clothFacetIndex->getCountByCompareRuleList(...$query->getCriteriaList()); // запрос количество позиций по заданным критериям

$clothFacetIndex->getItemIdListByCompareRuleList(...$query->getCriteriaList()); // список идентификтов одежды соотвествующей критериям

$clothFacetIndex->getActualPropertyValuesForCompareRuleList(...$query->getCriteriaList()); // список свойств с актуальными значениями (совместимыми с текущими критериями) и количеством позиций по каждому из значений

$clothFacetIndex->getFacetResultForCompareRuleList(...$query->getCriteriaList()); // результат аналогичен предыдущему за исключением того что возвращается объект вместо массива.

$clothFacetIndex->clearFacetForItemId(1); // удаляем все данные из индекса для позиции с идентификатором 1

// добавляем новый товар в индекс
$clothFacetIndex->addItemIdForValueByProperty('color', 'red', 1);
$clothFacetIndex->addItemIdForValueByProperty('size', 'M', 1);
$clothFacetIndex->addItemIdForValueByProperty('gender', 'male', 1);
$clothFacetIndex->addItemIdForValueByProperty('type', 'hat', 1);
```

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 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

6

Last Release

1090d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c75fd54c926c6b835a6b6cd92514d60d55a285d35847b9f22aefcc7ad5ef9ae7?d=identicon)[nnagornyy](/maintainers/nnagornyy)

---

Top Contributors

[![alex19pov31](https://avatars.githubusercontent.com/u/786683?v=4)](https://github.com/alex19pov31 "alex19pov31 (12 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/beta-facetedsearch/health.svg)

```
[![Health](https://phpackages.com/badges/beta-facetedsearch/health.svg)](https://phpackages.com/packages/beta-facetedsearch)
```

###  Alternatives

[ruflin/elastica

Elasticsearch Client

2.3k50.4M202](/packages/ruflin-elastica)[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)[massive/search-bundle

Massive Search Bundle

721.4M13](/packages/massive-search-bundle)[shyim/opensearch-php-dsl

OpenSearch/Elasticsearch DSL library

175.9M9](/packages/shyim-opensearch-php-dsl)[outl1ne/nova-multiselect-filter

Multiselect filter for Laravel Nova.

45802.7k3](/packages/outl1ne-nova-multiselect-filter)

PHPackages © 2026

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