Install

Works with Drupal: 8.x

Using Composer to manage Drupal site dependencies

Alternative installation files

Download search_api_solr-8.x-3.8.tar.gztar.gz 1.04 MB
MD5: 6de78aceaf9f04f8b03c70e0789cc96a
SHA-1: 6f0a51b8d5079cd1c37142bbd58bfeef521f2511
SHA-256: 9597f2805f7b6c470a330b7c74d842807c9c45ed0b683da07ce4958b21d25084
Download search_api_solr-8.x-3.8.zipzip 1.26 MB
MD5: 38375ad12df86919a8615b87140c27a5
SHA-1: 5c47090d817410ae06a6e096f2aabf3f99e43520
SHA-256: 670b2fc928f13fd2117706d1f7f405964b3f24b8beec910b21818dc753198463

Release notes

Another maintenance release of Search API Solr Search 8.x-3.x. It supports upgrade paths from any previous 8.x version including Search API Solr Multilingual 8.x-1.x!

BTW there's a new user contributed documentation: https://www.drupal.org/docs/8/modules/search-api-solr

The big changes in 3.x compared to 2.x:

  • We collapsed the features of the Standard Backend, both Multilingual Backends and the "Any Schema" Backend into a one new unified Solr Backend. There's a migration path :-)
  • Mulitisite is back! Select "Clone for Multisite" in an Index' operations, save the Clone Form, export the cloned index config (and probably the server config), deploy the config to a different site, configure a search View as usual, enjoy! ;-)
  • Spellchecking is now configurable like Suggesters. Use the standard filed configuration to decide which fields should feed the spellcheck catalog
  • We now distinguish between NGram and EdgeNGram. Both field types are fully configurable via Drupal config files.
  • We upgraded to solarium 5.0 and therefore require at least PHP 7.1
  • Experimental support for installation via Ludwig (removed with 8.x-3.6 because Ludwig isn't able to manage conflicting requirements in a reliable way which might lead to fatal errors. Use composer!)
  • Solr 7/8 compatible implementation of index time boosting of terms and documents
  • Configurable MoreLikeThis parameters per index
  • Support for Solr Cloud exclusive features

The big changes in 3.x compared to 1.x:

Important: Since solarium 5.0 supports Solr v2 API, the connector settings need to be adjusted! The "path" must not end with "/solr" but "/" without "solr" because that is the v1 API endpoint!
Your existing configs will be adjusted automatically via an update hook implementation. But if you've overwritten the connection settings (for example in settings.php) you must adjust the path by yourself!

Important: You need to update your Solr config files if you update from any previous version! After deploying the config set to your Solr server(s) you need to re-index your content!

Important: You might need to adjust the solrcore.properties file to your needs. If you get errors about missing classes you should adjust the solr.install.dir.

Solr 6 and 7 and 8, nothing else!

The minimum supported Solr version is 6.4. But due to security issues it's highly recommended that you use at least Solr 7.7.2!

As you can see at https://lucene.apache.org/solr/downloads.html the Solr project itself declared "End Of Life" (EOL) for any Solr version before 7.7.

If you use Solr 6.5.x you have to be aware that there's a known issue within Solr itself that always leads to zero results in combination with search_api_autocomplete: #2869529: Autocomplete (and spell checking) is broken on Solr 6.5.x, Solr 6.6 will solve the issue.
Since this bug is fixed in Solr 6.6.0 we declare Solr 6.5.x as unsupported!

PHP 7.1 or newer required!

Due to the requirements of the libraries we use we can't support PHP 5 and PHP 7.0 anymore!

The recommended way to install this module properly is the usage of composer!

To install the module including its dependencies simply change into your drupal directory and run composer require drupal/search_api_solr:^3.0.
But if you just download the module it won't work because the required external libraries are not part of this package!

The symfony/event-dispatcher issue!

Since solarium 5.1 contains important bug fixes that solve issues for Drupal user's as well, we highly recommend solarium 5.1 for search_api_solr 8.x-3.7. But until #2876675: Allow symfony/event-dispatcher 4+ to be installed in Drupal 8 gets committed to core and released, you might need to run an adjusted composer command for installation, see #3085196: How to upgrade to solarium 5.1.x, 5.2.x or 6.0.x for details.

Upgrade path for Search API Multilingual Solr Search 8.x-1.x

You should NOT upgrade to 8.x-2.x first before you upgrade to 8.x-3.x! Just directly upgrade to 8.x-3.x.

Changes since 8.x-3.7

Changes since 8.x-3.6

Changes since 8.x-3.5

Changes since 8.x-3.4

Changes since 8.x-3.3

Changes since 8.x-3.2

Changes since 8.x-3.1

Changes since 8.x-3.0

Changes since 8.x-3.0-rc1

Changes since 8.x-3.0-beta3

Changes since 8.x-3.0beta2

Changes since 8.x-3.0beta1

Changes since 8.x-3.0alpha3

Changes since 8.x-3.0alpha2

Changes since 8.x-3.0alpha1

Changes since 8.x-2.x

Created by: mkalkbrenner
Created on: 2 Jan 2020 at 15:50 UTC
Last updated: 14 Feb 2020 at 17:12 UTC
Bug fixes
New features

Other releases