README

The Apache Solr PHP extension is an extremely fast, light-weight, feature-rich library that allows PHP applications to communicate easily and efficiently with Apache Solr server instances using an object-oriented API.

This version of the extension requires Apache Solr Server at least version 4.0.

• https://pecl.php.net/package/solr

Please refer to https://www.php.net/manual/en/book.solr.php and README.* for more information

Installation

This library requires curl and libxml2 development packages and php extensions

For Debian/Ubuntu/Mint

    sudo apt-get install php5-curl libcurl4-gnutls-dev libxml2 libxml2-dev

For RHEL/Fedora/CentOS/Scientific linux

    sudo yum install libxml2-devel curl-devel php-curl

Please make sure to install them before proceeding to the compilation process

    phpize
    ./configure
    make
    make test
    sudo make install

more details on README.INSTALLATION

Contributions

All forms of contributions are welcome! Whether contributing to tests, or the source.

Support & Sponsorship

The PHP Solr Extension has been around since 2010 without any financial backing. Today, We'd like to transform it into an ODM (Object Document Mapper), a milestone we can't reach without your support, as there will be significant work up ahead. Giving back will help us in this transformation!

Running Tests

Types of tests

1. Tests that do not require a Solr Server (some of them use fixture files)
2. Requires a running server with cores present and populated with data.

There is a configuration file for the test suite, located at tests/test.config.inc It contains the fixture file definitions and other configurations for the Solr Server to be used for testing.

To run the type 2 tests, you'll need docker to run the test server using the following command:

docker-compose up -d
export SOLR_SERVER_CONFIGURED=1
php run-tests.php -q -d extension=$PWD/modules/solr.so --show-diff
# or make test

PHPQA Guide: https://qa.php.net/write-test.php

make test

How to Report Bugs

Please report bugs to https://bugs.php.net

If you experience a crash due to a segmentation fault, please follow the instructions on the link below to get a gdb backtrace and then submit the trace in your bug report as well

https://bugs.php.net/bugs-generating-backtrace.php

Thank you for using PHP