PHPackages                             solarium/solarium - 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. solarium/solarium

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

solarium/solarium
=================

PHP Solr client

6.4.1(7mo ago)93432.7M—6.7%300[10 issues](https://github.com/solariumphp/solarium/issues)[1 PRs](https://github.com/solariumphp/solarium/pulls)20BSD-3-ClausePHPPHP ^8.1CI failing

Since Jan 4Pushed 3w ago48 watchersCompare

[ Source](https://github.com/solariumphp/solarium)[ Packagist](https://packagist.org/packages/solarium/solarium)[ Docs](http://www.solarium-project.org)[ RSS](/packages/solarium-solarium/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (19)Versions (97)Used By (20)

Solarium PHP Solr Client Library
================================

[](#solarium-php-solr-client-library)

What is Solarium?
-----------------

[](#what-is-solarium)

Solarium is a PHP Solr client library that accurately models Solr concepts. Where many other Solr libraries only handle the communication with Solr, Solarium also relieves you of handling all the complex Solr query parameters using a well documented API.

Please see the [docs](http://solarium.readthedocs.io/en/stable/) for a more detailed description.

Requirements
------------

[](#requirements)

Solarium 6.3.7 and up only supports PHP 8.1 and up.

It's highly recommended to have cURL enabled in your PHP environment. However if you don't have cURL available you can switch from using cURL (the default) to a pure PHP based HTTP client adapter which works for the essential stuff but doesn't support things like parallel query execution.

Alternatively you can inject any PSR-18 compatible HTTP Client using the `Psr18Adapter`.

Getting started
---------------

[](#getting-started)

The preferred way to install Solarium is by using Composer. Solarium is available on [Packagist](https://packagist.org/packages/solarium/solarium).

Example:

```
composer require solarium/solarium
```

Pitfalls when upgrading from earlier versions
---------------------------------------------

[](#pitfalls-when-upgrading-from-earlier-versions)

When upgrading from an earlier version, you should be aware of a number of pitfalls.

- [Pitfalls when upgrading to 7.0.0](https://solarium.readthedocs.io/en/stable/getting-started/#pitfalls-when-upgrading-to-700)
- [Pitfall when upgrading to 6.3.6](https://solarium.readthedocs.io/en/stable/getting-started/#pitfall-when-upgrading-to-636)
- [Pitfall when upgrading to 6.3.2](https://solarium.readthedocs.io/en/stable/getting-started/#pitfall-when-upgrading-to-632)
- [Pitfall when upgrading to 6.3](https://solarium.readthedocs.io/en/stable/getting-started/#pitfall-when-upgrading-to-63)
- [Pitfalls when upgrading from 3.x or 4.x or 5.x](https://solarium.readthedocs.io/en/stable/getting-started/#pitfalls-when-upgrading-from-3x-or-4x-or-5x)
- [Pitfall when upgrading from 3.x or 4.x](https://solarium.readthedocs.io/en/stable/getting-started/#pitfall-when-upgrading-from-3x-or-4x)

Run the examples
----------------

[](#run-the-examples)

To run the examples read through the [Example code](https://solarium.readthedocs.io/en/stable/getting-started/#example-code)section of the documentation.

Run the tests
-------------

[](#run-the-tests)

The phpunit tests contain some integration tests that require a running Solr instance. And this Solr instance requires some special configuration. Have a look at `.github/workflows/run-tests.yml` to see how to start a well configured Solr docker container locally. If you just want to run the unit tests, just ensure that there's no other Solr server listening on the standard port 8983 and the integration tests will be skipped.

You can run the tests in a Windows environment. For all of them to pass, you must make sure to [checkout with `LF` line endings](https://docs.github.com/en/github/using-git/configuring-git-to-handle-line-endings).

More information
----------------

[](#more-information)

- Docs
- Issue tracker
- Contributors
- License See the COPYING file or view online:

Continuous Integration status
-----------------------------

[](#continuous-integration-status)

- [![Run Tests](https://github.com/solariumphp/solarium/workflows/Run%20Tests/badge.svg)](https://github.com/solariumphp/solarium/actions)
- [![codecov](https://camo.githubusercontent.com/15377f50f03586fe0a589b5c3130ce5f857c15d5d1e32a006f889f2e527aa425/68747470733a2f2f636f6465636f762e696f2f67682f736f6c617269756d7068702f736f6c617269756d2f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/solariumphp/solarium)
- [![Total Downloads](https://camo.githubusercontent.com/a71c6eac474e60234e38da36df03907baa6d346b9720391acb2b92f9cfc9c11b/68747470733a2f2f706f7365722e707567782e6f72672f736f6c617269756d2f736f6c617269756d2f646f776e6c6f6164732e737667)](https://packagist.org/packages/solarium/solarium)

###  Health Score

77

—

ExcellentBetter than 100% of packages

Maintenance82

Actively maintained with recent releases

Popularity74

Solid adoption and visibility

Community53

Growing community involvement

Maturity88

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 55.2% 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 ~55 days

Recently: every ~20 days

Total

94

Last Release

133d ago

Major Versions

v3.9.0-alpha → 4.0.0-alpha.12018-01-26

4.x-dev → 5.0.0-alpha.12019-04-08

5.x-dev → 6.0.0-alpha.12020-06-05

3.x-dev → 6.0.12020-07-03

6.4.x-dev → 7.0.0-alpha.12025-10-18

PHP version history (11 changes)2.3.0PHP >=5.2.0

3.0.0-RC1PHP >=5.3.2

v3.9.0-alphaPHP >=5.3.9

4.0.0-alpha.1PHP ^7.0

4.3.0-alpha1PHP ^7.1

5.1.1PHP ^7.1.3

6.0.0-beta.1PHP ^7.2

6.0.4PHP ^7.2 || ^8.0

6.1.0PHP ^7.3 || ^8.0

6.3.2PHP ^8.0

6.3.7PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/2af94ef010ed1c8d5e18f43c1099daaa892108b99870d0a91b7bab6fa7386597?d=identicon)[basdenooijer](/maintainers/basdenooijer)

![](https://www.gravatar.com/avatar/2bc8e4b2a585cedae1909fc72a3a9f2808bdcd92e61189d20b9e613a8dc52f82?d=identicon)[mkalkbrenner](/maintainers/mkalkbrenner)

---

Top Contributors

[![basdenooijer](https://avatars.githubusercontent.com/u/580644?v=4)](https://github.com/basdenooijer "basdenooijer (723 commits)")[![thomascorthals](https://avatars.githubusercontent.com/u/12425704?v=4)](https://github.com/thomascorthals "thomascorthals (222 commits)")[![mkalkbrenner](https://avatars.githubusercontent.com/u/557921?v=4)](https://github.com/mkalkbrenner "mkalkbrenner (97 commits)")[![Gasol](https://avatars.githubusercontent.com/u/108053?v=4)](https://github.com/Gasol "Gasol (58 commits)")[![jsteggink](https://avatars.githubusercontent.com/u/978411?v=4)](https://github.com/jsteggink "jsteggink (42 commits)")[![wickedOne](https://avatars.githubusercontent.com/u/343850?v=4)](https://github.com/wickedOne "wickedOne (21 commits)")[![localheinz](https://avatars.githubusercontent.com/u/605483?v=4)](https://github.com/localheinz "localheinz (17 commits)")[![thePanz](https://avatars.githubusercontent.com/u/226021?v=4)](https://github.com/thePanz "thePanz (17 commits)")[![dmaicher](https://avatars.githubusercontent.com/u/921145?v=4)](https://github.com/dmaicher "dmaicher (12 commits)")[![stefanooldeman](https://avatars.githubusercontent.com/u/415560?v=4)](https://github.com/stefanooldeman "stefanooldeman (9 commits)")[![chadicus](https://avatars.githubusercontent.com/u/1182337?v=4)](https://github.com/chadicus "chadicus (9 commits)")[![marinpurgar](https://avatars.githubusercontent.com/u/1115765?v=4)](https://github.com/marinpurgar "marinpurgar (9 commits)")[![Hywan](https://avatars.githubusercontent.com/u/946104?v=4)](https://github.com/Hywan "Hywan (7 commits)")[![ee-dev](https://avatars.githubusercontent.com/u/4332212?v=4)](https://github.com/ee-dev "ee-dev (6 commits)")[![timohund](https://avatars.githubusercontent.com/u/964675?v=4)](https://github.com/timohund "timohund (5 commits)")[![shieldo](https://avatars.githubusercontent.com/u/97280?v=4)](https://github.com/shieldo "shieldo (5 commits)")[![igorw](https://avatars.githubusercontent.com/u/88061?v=4)](https://github.com/igorw "igorw (5 commits)")[![acasademont](https://avatars.githubusercontent.com/u/825021?v=4)](https://github.com/acasademont "acasademont (4 commits)")[![gsdevme](https://avatars.githubusercontent.com/u/319498?v=4)](https://github.com/gsdevme "gsdevme (4 commits)")[![jaytaph](https://avatars.githubusercontent.com/u/241458?v=4)](https://github.com/jaytaph "jaytaph (4 commits)")

---

Tags

phpsolariumsolrsolr-librariesphpsearchsolr

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[opensearch-project/opensearch-php

PHP Client for OpenSearch

15224.3M65](/packages/opensearch-project-opensearch-php)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6939.5M343](/packages/drupal-core-recommended)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

81733.7k](/packages/flow-php-flow)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[apache-solr-for-typo3/solr

Apache Solr for TYPO3 - Apache Solr for TYPO3 is the enterprise search server you were looking for with special features such as Faceted Search or Synonym Support and incredibly fast response times of results within milliseconds.

1473.0M32](/packages/apache-solr-for-typo3-solr)

PHPackages © 2026

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