# smile/elasticsuite 2.12.1

> Version 2.12.1 of smile/elasticsuite, released 2026-08-04.

`composer require smile/elasticsuite:2.12.1`

Canonical URL: https://packagento.com/smile/elasticsuite/2.12.1

## At a glance

- **Released**: 2026-08-04
- **Magento**: >=103.0.6
- **QA**: failing

## What it does

Magento 2 merchandising and search engine built on ElasticSearch

## Dependencies

### Require

| Package | Constraint |
|---|---|
| magento/framework | >=103.0.6 |
| magento/magento-composer-installer | * |
| magento/module-backend | >=102.0.6 |
| magento/module-catalog | >=104.0.6 |
| magento/module-catalog-graph-ql | >=100.4.6 |
| magento/module-catalog-search | >=102.0.6 |
| magento/module-store | >=101.1.6 |
| opensearch-project/opensearch-php | ^1.0 \|\| ^2.0 <2.4.0 \|\| >=2.4.3 <3.0.0 |

### Require (dev)

| Package | Constraint |
|---|---|
| smile/magento2-smilelab-quality-suite | ~2.2.0 |

### Replace

| Package | Constraint |
|---|---|
| smile/module-elasticsuite-admin-notification | self.version |
| smile/module-elasticsuite-analytics | self.version |
| smile/module-elasticsuite-catalog | self.version |
| smile/module-elasticsuite-catalog-graph-ql | self.version |
| smile/module-elasticsuite-catalog-optimizer | self.version |
| smile/module-elasticsuite-catalog-rule | self.version |
| smile/module-elasticsuite-core | self.version |
| smile/module-elasticsuite-indices | self.version |
| smile/module-elasticsuite-swatches | self.version |
| smile/module-elasticsuite-thesaurus | self.version |
| smile/module-elasticsuite-tracker | self.version |
| smile/module-elasticsuite-virtual-category | self.version |

## Quality

Version 2.12.1 fails the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.


### Compatibility

Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | Pass | – |
| 2.4.9 | – | – | Pass | Pass |


### Code Quality

Advisory checks against the module's source. Never affect the Compatibility verdict — a phpcs finding can't make a module incompatible.

#### Static Analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Fail | 4316 | 151 errors, 4165 warnings (ruleset: Magento2), 2873 auto-fixable with phpcbf |
| PHPMD | Pass | 0 |  |
| Cpd | Warning | 41 | 41 duplicated chunks spanning 2385 total lines (min-lines=5, min-tokens=70) |
| Composer validate | Info | 7 | valid; 7 advisory notes (composer validate --strict) |

#### PHPStan

Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | 860 | 860 | – | – |
| 2.4.8 | – | 860 | 860 | – |
| 2.4.9 | – | – | 852 | 852 |


### Tests

Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.

#### Unit Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |

#### Integration Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |


### Security

Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | Pass | 0 |  |
| Malware scan | Pass | 0 |  |

## Parent package

[smile/elasticsuite](https://packagento.com/smile/elasticsuite.md) — full catalogue, pricing, install steps, and vendor info.