« Changelog History


Solarium v6.0.1 Release Notes

Release Date: 2020-07-03 // almost 4 years ago

  • 🔄 Changes since 6.0.0

    ➕ Added

    • Solarium\Component\Result\Facet\JsonRange::getBefore()
    • Solarium\Component\Result\Facet\JsonRange::getAfter()
    • Solarium\Component\Result\Facet\JsonRange::getBetween()

    🔄 Changed

    • Json range facet result now returns Solarium\Component\Result\Facet\JsonRange

    🔄 Changes since 5.2.0

    ➕ Added

    • \Solarium\Component\Result\Facet\Buckets::getNumBuckets()
    • 👍 \Solarium\Support\Utility::getXmlEncoding()
    • ⚡️ Raw XML commands to update query
    • ⚡️ Raw XML from file in update query
    • ⚡️ Set input encoding for select and update queries
    • 🔧 Create and configure Managed Resources

    🔄 Changed

    • 👻 Thrown exceptions always implement Solarium\Exception\ExceptionInterface
    • PostBigRequest plugin now acts on PRE_EXECUTE_REQUEST event instead of POST_CREATE_REQUEST
    • CustomizeRequest plugin now acts on POST_CREATE_REQUEST event instead of PRE_EXECUTE_REQUEST
    • More strict types and type hinting
    • 🔧 AdapterInterface does not extend ConfigurableInterface anymore
    • 🔧 Http Adapter does not implement ConfigurableInterface anymore
    • 🔧 Psr18Adapter does not implement ConfigurableInterface anymore
    • Solarium Client now accepts any PSR-15 compatible event dispatcher (previously it had to be symfony's event dispatcher)

    🛠 Fixed

    • 📜 MoreLikeThis result parsing fails on Solr Cloud
    • 🔌 MinimumScoreFilter plugin might fail on Solr 7 in cloud mode

    ✂ Removed

    • 👍 PHP 7.1 support
    • Zend2HttpAdapter
    • GuzzleAdapter
    • Guzzle3Adapter
    • Endpoint::setTimeout and Endpoint::getTimeout
    • Passing local parameter options (e.g. key, tag, exclude) without the local_ prefix
    • 👌 Support for Solr versions before 7.7

    ⬆️ Pitfall when upgrading from 3.x or 4.x or 5.x

    🗄 Setting "timeout" as "option" in the HTTP Client Adapter is deprecated since Solarium 5.2.0 because not all adapters
    could handle it. The adapters which can handle it now implement the TimeoutAwareInterface and you need to set the
    ⏱ timeout using the setTimeout() function after creating the adapter instance.

    In order to fix some issues with complex queries using local parameters solarium 6 destinguishs between query parameters
    🗄 and local parameters to be embedded in a query. Solarium 5.2 already informed you about the deprecation of some
    parameter names which are in fact local parameters. Solarium doen't convert them magically anymore.
    🛠 Local parameter names now have to be prefixed with local_ if set as option of a constructor.

    Solarium 5:

    $categoriesTerms = new Solarium\Component\Facet\JsonTerms(['key' =\> 'categories', 'field' =\> 'cat', 'limit'=\>4,'numBuckets'=\>true]);

    Solarium 6:

    $categoriesTerms = new Solarium\Component\Facet\JsonTerms(['local\_key' =\> 'categories', 'field' =\> 'cat', 'limit'=\>4,'numBuckets'=\>true]);

    See https://lucene.apache.org/solr/guide/8_5/local-parameters-in-queries.html for an introduction about local parameters.

    ⬆️ Pitfall when upgrading from 3.x or 4.x

    In the past, the V1 API endpoint solr was not added automatically, so most users set it as path on the endpoint.
    👍 This bug was discovered with the addition of V2 API support. In almost every setup, the path has to be set to /
    🚀 instead of /solr with this release!

    For the same reason it is a must to explicit configure the core or collection.

    So an old setting like

    'path' => '/solr/xxxx/'

    has to be changed to something like

    'path' => '/',
'collection' => 'xxxx',