<aid="welcome-to-github-pages"class="anchor"href="#welcome-to-github-pages"aria-hidden="true"><spanclass="octicon octicon-link"></span></a>Welcome to GitHub Pages.</h3>
<p>Solarium is a Solr client library for PHP. It is developed with these goals in mind:</p>
<p>This automatic page generator is the easiest way to create beautiful pages for all of your projects. Author your page content here using GitHub Flavored Markdown, select a template crafted by a designer, and publish. After your page is generated, you can check out the new branch:</p>
<ul>
<li>Releave developers of the ‘raw communication’ with Solr, ie. setting params, building strings, hiding all this with an easy to use API, allowing you to focus on business logic.</li>
<li>Allow for reuse, for instance a query can be extended to modify it</li>
<li>Be flexible. For instance the query and result models are not tied to a specific Solr client implementation. There are multiple Solr Client adapters for Solr communication. All models can be extended by your own implementation if needed and a plugin system is available.</li>
<li>Be usable in any PHP application. No dependencies on other frameworks. Solarium tries to follow the Symfony 2 standard and integrates nicely with SF2, but doesn’t in rely on it. You can use Solarium just as easily in Zend Framework or any other PHP framework.</li>
<li>Accurately model Solr. For instance the updating of a Solr index. Most clients have separate add, delete and commit methods that also issue separate requests. But Solr actually has an update handler that supports all those actions in a single request. The model should reflect this while keeping it easy to use.</li>
<li>Find a good balance between nice and feature-rich code and performance. A library/framework for general use will never be as fast as a custom implementation that only contains the bare minimum for your use case. But the performance difference between the two should be at a reasonable level. And because of the dynamic nature of PHP the models can’t be too extensive, yet they should not be over-simplified.</li>
<li>Only implement basic functionality in the standard models. All additional functionality should be in separate code that only gets loaded when used. This benefits performance, but also helps to prevent classes with huge APIs. The query components and plugins are a good example.</li>
</ul>
<pre><code>$ cd your_repo_root/repo_name
$ git fetch origin
$ git checkout gh-pages
<h3>
<aid="quick-start-using-composer"class="anchor"href="#quick-start-using-composer"aria-hidden="true"><spanclass="octicon octicon-link"></span></a>Quick start using Composer</h3>
<p>If you are familiar with Composer and have it set up in your project just issue the following command in your project root directory:</p>
<pre><code>$ composer require
</code></pre>
<p>If you're using the GitHub for Mac, simply sync your repository and you'll see the new branch.</p>
<p>For more info see the 'Getting started' section in the docs.</p>
<p>We've crafted some handsome templates for you to use. Go ahead and continue to layouts to browse through them. You can easily go back to edit your page before publishing. After publishing your page, you can revisit the page generator and switch to another theme. Your Page content will be preserved if it remained markdown format.</p>
<p>You can find a lot of documentation, including a 'Getting started' section here: <ahref="http://solarium.readthedocs.org/en/stable/">http://solarium.readthedocs.org/en/stable/</a></p>
<p>Any help on Solarium is very welcome. Please take a look at the pointers below, but your PR is always welcome. If there are any issues someone might be able to help you or continue working on the PR.</p>
<p>If you prefer to not use the automatic generator, push a branch named <code>gh-pages</code> to your repository to create a page manually. In addition to supporting regular HTML content, GitHub Pages support Jekyll, a simple, blog aware static site generator written by our own Tom Preston-Werner. Jekyll makes it easy to create site-wide headers and footers without having to copy them across every page. It also offers intelligent blog support and other advanced templating features.</p>
<ul>
<li>Your pull requests should target the develop branch, not master. Nothing will be directly merged into master!</li>
<li>A pull request should be mergeable (fast-forward) </li>
<li>Ideally any change should include updated or new unittests to cover the changes and updates to the docs. You can submit a PR without tests / docs, but it might take longer to merge as someone else will need to fix this.</li>
<li>Solarium follows the Symfony2 code standards: <ahref="http://symfony.com/doc/current/contributing/code/standards.html">http://symfony.com/doc/current/contributing/code/standards.html</a>
</li>
<li>Each PR will be checked by the CI environment automatically. Ofcourse anything other than a 'green' status needs to be fixed before a PR can be merged.</li>
</ul>
<h3>
<aid="authors-and-contributors"class="anchor"href="#authors-and-contributors"aria-hidden="true"><spanclass="octicon octicon-link"></span></a>Authors and Contributors</h3>
<p>You can <ahref="https://github.com/blog/821"class="user-mention">@mention</a> a GitHub username to generate a link to their profile. The resulting <code><a></code> element will link to the contributor's GitHub Profile. For example: In 2007, Chris Wanstrath (<ahref="https://github.com/defunkt"class="user-mention">@defunkt</a>), PJ Hyett (<ahref="https://github.com/pjhyett"class="user-mention">@pjhyett</a>), and Tom Preston-Werner (<ahref="https://github.com/mojombo"class="user-mention">@mojombo</a>) founded GitHub.</p>
<p>Solarium uses the Github issues for tracking bugs and feature requests: <ahref="https://github.com/solariumphp/solarium/issues">https://github.com/solariumphp/solarium/issues</a>. Please keep the following in mind when creating a bug report:</p>
<h3>
<aid="support-or-contact"class="anchor"href="#support-or-contact"aria-hidden="true"><spanclass="octicon octicon-link"></span></a>Support or Contact</h3>
<ul>
<li>Bugs are intended for problems in the code or missing / faulty documentation. Not for issues with your own environment, questions in how to use feature X etcetera. For these questions you can use platforms like StackOverflow.</li>
<li>Include info about your environment: the version of Solarium you are using, PHP version, Solr version
If you get a specific error, include as much info as possible. The PHP exception, a Solr error log line, anything that might help.</li>
<li>When something doesn't work as expected for you, also describe the behaviour you expect.</li>
<li>Do a quick search to check if the issue has already been reported</li>
<li>Describe your issue well, especially the title. Instead of ‘Select query exception’ use ‘Using a dash in a filterquery tag causes an exception’.</li>
<li>Provide steps to reproduce the issue. A unittest is ideal, but a description of manual steps is also very helpful.</li>
</ul>
<p>Having trouble with Pages? Check out the documentation at <ahref="https://help.github.com/pages">https://help.github.com/pages</a> or contact <ahref="mailto:support@github.com">support@github.com</a> and we’ll help you sort it out.</p>
</section>
<footerclass="site-footer">
<spanclass="site-footer-owner"><ahref="https://github.com/solariumphp/solarium">Solarium</a> is maintained by <ahref="https://github.com/solariumphp">solariumphp</a>.</span>
<pclass="repo-owner"><ahref="https://github.com/solariumphp/solarium"></a> is maintained by <ahref="https://github.com/solariumphp">solariumphp</a>.</p>
<p>This page was generated by <ahref="https://pages.github.com">GitHub Pages</a> using the Architect theme by <ahref="https://twitter.com/jasonlong">Jason Long</a>.</p>
</aside>
</div>
</div>
<spanclass="site-footer-credits">This page was generated by <ahref="https://pages.github.com">GitHub Pages</a> using the <ahref="https://github.com/jasonlong/cayman-theme">Cayman theme</a> by <ahref="https://twitter.com/jasonlong">Jason Long</a>.</span>
{"name":"Solarium","tagline":"PHP Solr client","body":"### Welcome to GitHub Pages.\r\nThis automatic page generator is the easiest way to create beautiful pages for all of your projects. Author your page content here using GitHub Flavored Markdown, select a template crafted by a designer, and publish. After your page is generated, you can check out the new branch:\r\n\r\n```\r\n$ cd your_repo_root/repo_name\r\n$ git fetch origin\r\n$ git checkout gh-pages\r\n```\r\n\r\nIf you're using the GitHub for Mac, simply sync your repository and you'll see the new branch.\r\n\r\n### Designer Templates\r\nWe've crafted some handsome templates for you to use. Go ahead and continue to layouts to browse through them. You can easily go back to edit your page before publishing. After publishing your page, you can revisit the page generator and switch to another theme. Your Page content will be preserved if it remained markdown format.\r\n\r\n### Rather Drive Stick?\r\nIf you prefer to not use the automatic generator, push a branch named `gh-pages` to your repository to create a page manually. In addition to supporting regular HTML content, GitHub Pages support Jekyll, a simple, blog aware static site generator written by our own Tom Preston-Werner. Jekyll makes it easy to create site-wide headers and footers without having to copy them across every page. It also offers intelligent blog support and other advanced templating features.\r\n\r\n### Authors and Contributors\r\nYou can @mention a GitHub username to generate a link to their profile. The resulting `<a>` element will link to the contributor's GitHub Profile. For example: In 2007, Chris Wanstrath (@defunkt), PJ Hyett (@pjhyett), and Tom Preston-Werner (@mojombo) founded GitHub.\r\n\r\n### Support or Contact\r\nHaving trouble with Pages? Check out the documentation at https://help.github.com/pages or contact support@github.com and we’ll help you sort it out.\r\n","google":"","note":"Don't delete this file! It's used internally to help with page regeneration."}
\ No newline at end of file
{"name":"Solarium","tagline":"PHP Solr client","body":"\r\n### Solarium PHP Solr client\r\n\r\nSolarium is a Solr client library for PHP. It is developed with these goals in mind:\r\n\r\n* Releave developers of the ‘raw communication’ with Solr, ie. setting params, building strings, hiding all this with an easy to use API, allowing you to focus on business logic.\r\n* Allow for reuse, for instance a query can be extended to modify it\r\n* Be flexible. For instance the query and result models are not tied to a specific Solr client implementation. There are multiple Solr Client adapters for Solr communication. All models can be extended by your own implementation if needed and a plugin system is available.\r\n* Be usable in any PHP application. No dependencies on other frameworks. Solarium tries to follow the Symfony 2 standard and integrates nicely with SF2, but doesn’t in rely on it. You can use Solarium just as easily in Zend Framework or any other PHP framework.\r\n* Accurately model Solr. For instance the updating of a Solr index. Most clients have separate add, delete and commit methods that also issue separate requests. But Solr actually has an update handler that supports all those actions in a single request. The model should reflect this while keeping it easy to use.\r\n* Find a good balance between nice and feature-rich code and performance. A library/framework for general use will never be as fast as a custom implementation that only contains the bare minimum for your use case. But the performance difference between the two should be at a reasonable level. And because of the dynamic nature of PHP the models can’t be too extensive, yet they should not be over-simplified.\r\n* Only implement basic functionality in the standard models. All additional functionality should be in separate code that only gets loaded when used. This benefits performance, but also helps to prevent classes with huge APIs. The query components and plugins are a good example.\r\n\r\n### Quick start using Composer\r\n\r\nIf you are familiar with Composer and have it set up in your project just issue the following command in your project root directory:\r\n\r\n```\r\n$ composer require \r\n```\r\n\r\nFor more info see the 'Getting started' section in the docs.\r\n\r\n### Documentation\r\n\r\nYou can find a lot of documentation, including a 'Getting started' section here: http://solarium.readthedocs.org/en/stable/\r\n\r\n### Contributing\r\n\r\nAny help on Solarium is very welcome. Please take a look at the pointers below, but your PR is always welcome. If there are any issues someone might be able to help you or continue working on the PR.\r\n\r\n* Your pull requests should target the develop branch, not master. Nothing will be directly merged into master!\r\n* A pull request should be mergeable (fast-forward) \r\n* Ideally any change should include updated or new unittests to cover the changes and updates to the docs. You can submit a PR without tests / docs, but it might take longer to merge as someone else will need to fix this.\r\n* Solarium follows the Symfony2 code standards: http://symfony.com/doc/current/contributing/code/standards.html\r\n* Each PR will be checked by the CI environment automatically. Ofcourse anything other than a 'green' status needs to be fixed before a PR can be merged.\r\n\r\n### Bug reports\r\n\r\nSolarium uses the Github issues for tracking bugs and feature requests: https://github.com/solariumphp/solarium/issues. Please keep the following in mind when creating a bug report:\r\n\r\n* Bugs are intended for problems in the code or missing / faulty documentation. Not for issues with your own environment, questions in how to use feature X etcetera. For these questions you can use platforms like StackOverflow.\r\n* Include info about your environment: the version of Solarium you are using, PHP version, Solr version\r\nIf you get a specific error, include as much info as possible. The PHP exception, a Solr error log line, anything that might help.\r\n* When something doesn't work as expected for you, also describe the behaviour you expect.\r\n* Do a quick search to check if the issue has already been reported\r\n* Describe your issue well, especially the title. Instead of ‘Select query exception’ use ‘Using a dash in a filterquery tag causes an exception’.\r\n* Provide steps to reproduce the issue. A unittest is ideal, but a description of manual steps is also very helpful.","google":"","note":"Don't delete this file! It's used internally to help with page regeneration."}
