Install

Works with Drupal: 8.x

Using Composer to manage Drupal site dependencies

Alternative installation files

Download search_api_solr-8.x-3.6.tar.gztar.gz 1.03 MB
MD5: 9106234e20a4496459d07c5ab77f6bc6
SHA-1: 440ada6ce5be183f3f2ed79c1ffdf1f48e8674e9
SHA-256: d6b36962187046e010c80fd5251375704294d5fdbae3b01582dcda239c9373b2
Download search_api_solr-8.x-3.6.zipzip 1.23 MB
MD5: e2ef00d0278c9047c8ef58339583e2ea
SHA-1: acd6cf6141a81346b6b7e7be39351b9ea49691c6
SHA-256: 0c5e501d80aaa2a47831023beef1ea5a7917d852c2d8ad2317f65dab3c8a4985

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 decided to require solarium 5.1 for search_api_solr 8.x-3.5. But until #2876675: Allow symfony/event-dispatcher 4+ to be installed in Drupal 8 gets committed to core and released, you need to run an adjusted composer command for installation:
composer require symfony/event-dispatcher:"4.3.4 as 3.4.99" drupal/search_api_solr:^3.5
For an upgrade of search_api_solr you have to run this line before composer update:
composer require symfony/event-dispatcher:"4.3.4 as 3.4.99"

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.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: 25 Sep 2019 at 08:59 UTC
Last updated: 2 Oct 2019 at 20:53 UTC
Bug fixes

Other releases