Skip to content

Solr powered search handler for eZ Platform and eZ Publish 5.4.x

License

Notifications You must be signed in to change notification settings

alongosz/ezplatform-solr-search-engine

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Solr Search Engine Bundle for eZ Platform

Build Status

Solr Search Engine Bundle for use with:

  • eZ Platform (bundled out of the box as of 15.07 release)
  • eZ Publish Platform 5.4.5 and higher (optional, but recommended for scaling search queries)

Scope for 1.0 version of this bundle is to be able to power close to any kind of queries eZ Publish Platform 5.x users are currently running agains the LegacySearch engine (aka SQL Search/Storage engine), both Content and Location Search. This search engine is also taking advantage of Solr's Full text capabilities for language analysis, and it's scalability.

Version 1.0 is tested and will be supported with Solr 4.10.4, support for Solr 5.x will be added in a future update.

Other search features such as Faceting, Highlighting, .., not supported by the SQL search engine is planned for future versions. Some will be available by a simple composer patch update (0.0.z), for major (x.0.0) or minor (0.y.0) updates there will sometimes be a need to also re index your repository.

Install

For how to install and configure see:

Testing locally

For Contributing to this Bundle, you should make sure to run both unit and integration tests (from ezpublish-kernel repo).

  1. Setup this repository locally

    git clone git@github.com:ezsystems/ezplatform-solr-search-engine.git solr
    cd solr
    composer install

    At this point you should be able to run unit tests:

    php vendor/bin/phpunit --bootstrap tests/bootstrap.php
  2. Get & extract Solr 4.10.4

  3. Configure Solr (single core)

    Note: See .travis.yml and bin/.travis/init_solr.sh for multi core setups

    cp -R lib/Resources/config/solr/* solr-4.10.4/example/solr/collection1/conf
    For use in production/dev

    Note that Solr Bundle does not commit changes directly on repository updates, which can lead to issues of content not showing up in the index. You can control this by adjusting autoSoftCommit (visibility of change to search index) and autoCommit (hard commit, for durability and replication) values in solrconfig.xml.

    Example of working solrconfig.xml settings that you can use to tune for your needs, change from defaults is on autoSoftCommit from -1 (disabled) to 100ms:

      <autoCommit> 
        <maxTime>${solr.autoCommit.maxTime:15000}</maxTime> 
        <openSearcher>false</openSearcher> 
      </autoCommit>
    
      <autoSoftCommit> 
        <maxTime>${solr.autoSoftCommit.maxTime:100}</maxTime> 
      </autoSoftCommit>
    
  4. Start Solr

    Note: In this case in seperate terminal for debug use

    cd solr-4.10.4/example
    java -Djetty.port=8983 -jar start.jar
  5. Run integration tests

    export CORES_SETUP="single"
    php -d memory_limit=-1 vendor/bin/phpunit --bootstrap tests/bootstrap.php -vc vendor/ezsystems/ezpublish-kernel/phpunit-integration-legacy-solr.xml

Copyright & license

Copyright eZ Systems AS, for copyright and license details see provided LICENSE file.

About

Solr powered search handler for eZ Platform and eZ Publish 5.4.x

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 97.7%
  • Shell 2.3%