NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #3629 most downloaded on Packagist
Build and execute an Elasticsearch search query using a fluent PHP API
Last release 2 months ago
29 Jul 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 36 of 37 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
37 releases · first in 2021
Fix ReverseNestedAggregation emitting an empty aggs array by @ramicbenjamin in #83
ReverseNestedAggregation emitting an empty aggs array by @ramicbenjamin in #83Full Changelog: 3.10.0...3.11.0
ReverseNestedAggregation emitting an empty aggs array by @ramicbenjamin in https://github.com/spatie/elasticsearch-query-builder/pull/83Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.10.0...3.11.0
One column per quarter.
Add source() and retrieveFields(), deprecate fields() by @freekmurze in #82
Full Changelog: 3.9.2...3.10.0
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.9.2...3.10.0
feat: Enhance Builder class by adding Conditionable trait for improved query capabilities by @greezen in #79
Full Changelog: 3.9.1...3.9.2
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.9.1...3.9.2
Terms aggregation: Support "include" and "exclude" options for filtering values by @sventendo in #78
Full Changelog: 3.9.0...3.9.1
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.9.0...3.9.1
Update issue template by @AlexVanderbist in #77
ScriptSort on Query Builder by @chirag-techrayslabs in #75Full Changelog: 3.8.1...3.9.0
ScriptSort on Query Builder by @chirag-techrayslabs in https://github.com/spatie/elasticsearch-query-builder/pull/75Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.8.1...3.9.0
Add isEmpty method to BoolQuery by @floristenhove in #72
Full Changelog: 3.8.0...3.8.1
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.8.0...3.8.1
Add operator, boost, prefix length, and max expansions to MultiMatchQuery by @floristenhove in #71
Full Changelog: 3.7.0...3.8.0
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.7.0...3.8.0
Add DateHistogramAggregation by @Crmteam-IVG in #66
Full Changelog: 3.6.0...3.7.0
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.6.0...3.7.0
Add the min_score to the builder by @wgriffioen in #68
Full Changelog: 3.5.1...3.6.0
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.5.1...3.6.0
Collapse: Make use of nested inner hits query object by @sventendo in #67
Full Changelog: 3.5.0...3.5.1
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.5.0...3.5.1
Add elasticsearch collapse on query builder by @chirag-techrayslabs in https://github.com/spatie/elasticsearch-query-builder/pull/65
collapse on query builder by @chirag-techrayslabs in https://github.com/spatie/elasticsearch-query-builder/pull/65Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.4.0...3.5.0
Add MultiBuilder to support multi-search API by @chrispappas in https://github.com/spatie/elasticsearch-query-builder/pull/64
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.3.0...3.4.0
Add boost parameter to Terms query by @floristenhove in https://github.com/spatie/elasticsearch-query-builder/pull/54
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.2.2...3.3.0
Fix missing args for create func by @l3aro in https://github.com/spatie/elasticsearch-query-builder/pull/60
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.2.1...3.2.2
Support operator in MatchQuery by @l3aro in https://github.com/spatie/elasticsearch-query-builder/pull/59
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.2.0...3.2.1
Add percolate query by @floristenhove in https://github.com/spatie/elasticsearch-query-builder/pull/57
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.1.0...3.2.0
feat: add MatchPhraseQuery by @summerKK in https://github.com/spatie/elasticsearch-query-builder/pull/50
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/3.0.0...3.1.0
See upgrading.md for possible breaking changes.
See upgrading.md for possible breaking changes.
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/2.7.0...3.0.0
Allow bool and int as types for term query by @sventendo in https://github.com/spatie/elasticsearch-query-builder/pull/34
bool and int as types for term query by @sventendo in https://github.com/spatie/elasticsearch-query-builder/pull/34size and from in getPayload by @harlequin410 in https://github.com/spatie/elasticsearch-query-builder/pull/35Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/2.6.0...2.7.0
Add minimum_should_match support for BoolQuery by @srowan in https://github.com/spatie/elasticsearch-query-builder/pull/38
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/2.5.0...2.6.0
Add boost parameter to MatchQuery by @MilanLamote in https://github.com/spatie/elasticsearch-query-builder/pull/42
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/2.4.0...2.5.0
Add post filter logic and enhance readme by @MilanLamote in https://github.com/spatie/elasticsearch-query-builder/pull/41
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/2.3.0...2.4.0
Add highlighting by @MilanLamote in https://github.com/spatie/elasticsearch-query-builder/pull/39
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/2.2.0...2.3.0
Added able track total hits by @nick-rashkevich in https://github.com/spatie/elasticsearch-query-builder/pull/36
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/2.1.0...2.2.0
IB-1280 added sum aggregation by @webbaard in https://github.com/spatie/elasticsearch-query-builder/pull/26
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/2.0.1...2.1.0
Fix Builder::search() return data type by @imdhemy in https://github.com/spatie/elasticsearch-query-builder/pull/24
Builder::search() return data type by @imdhemy in https://github.com/spatie/elasticsearch-query-builder/pull/24Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/2.0.0...2.0.1
Elasticseach ^8.0 support by @h-rafiee in https://github.com/spatie/elasticsearch-query-builder/pull/19
Full Changelog: https://github.com/spatie/elasticsearch-query-builder/compare/1.4.0...2.0.0
- add TermsQuery
TermsQuery- add PrefixQuery
PrefixQueryremove debug statements (again )
- remove debug statements
- add type to MultiMatchQuery
type to MultiMatchQueryfix search_after parameter in request body
search_after parameter in request bodyadd search_after to request body
search_after to request body- provide default sort order - add searchAfter method
searchAfter method- initial release
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →