Official PHP client for Manticore Search.
❗ WARNING: this is a development version of the client. The latest release's readme is https://github.com/manticoresoftware/manticoresearch-php/tree/3.1.0
- One to one mapping with the HTTP API
- connection pools with pluggable selection strategy. Defaults to static round robin
- pluggable PSR/Log interface
- pluggable transport protocols.
- persistent connections
Requires PHP 7.1 or greater with the native JSON extension. Default transport handler uses the cURL extension.
Minimum Manticore Search version is 2.5.1 with HTTP protocol enabled.
| Manticore Search | manticoresearch-php | PHP |
|---|---|---|
| >= 6.2.0 | 3.1.x | >= 7.4, >=8.0 |
| >= 6.2.0 | 3.0.x | >= 7.4, >=8.0 |
| >= 6.0.4 | 3.0.x | >= 7.1, >=8.0 |
| >= 4.2.1 | 2.0.x, 2.1.x, 2.2.x | >= 7.1, >=8.0 |
| >= 4.0.2 | 1.7.x, 1.8.x | >= 7.1, >=8.0 |
| >= 3.5.2 | 1.6.x | >= 7.1, >=8.0 |
| >= 3.5.0 | 1.5.x | >= 7.1, <8.0 |
| >= 3.5.0 | 1.4 | >= 7.1, <8.0 |
| <= 3.4.x | 1.3 | >= 7.1, <8.0 |
| >= 2.5.1, <3.4.0 | 1.2 | >= 7.1, <8.0 |
Full documentation is available in docs folder.
Manticore Search server documentation: https://manual.manticoresearch.com/.
Install the Manticore Search PHP client using composer package manager:
composer require manticoresoftware/manticoresearch-phprequire_once __DIR__ . '/vendor/autoload.php';
$config = ['host'=>'127.0.0.1','port'=>9308];
$client = new \Manticoresearch\Client($config);
$index = $client->index('movies');$index->create([
'title'=>['type'=>'text'],
'plot'=>['type'=>'text'],
'_year'=>['type'=>'integer'],
'rating'=>['type'=>'float']
]);$index->addDocument([
'title' => 'Star Trek: Nemesis',
'plot' => 'The Enterprise is diverted to the Romulan homeworld Romulus, supposedly because they want to negotiate a peace treaty. Captain Picard and his crew discover a serious threat to the Federation once Praetor Shinzon plans to attack Earth.',
'_year' => 2002,
'rating' => 6.4
],
1);$index->addDocuments([
['id'=>2,'title'=>'Interstellar','plot'=>'A team of explorers travel through a wormhole in space in an attempt to ensure humanity\'s survival.','_year'=>2014,'rating'=>8.5],
['id'=>3,'title'=>'Inception','plot'=>'A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a C.E.O.','_year'=>2010,'rating'=>8.8],
['id'=>4,'title'=>'1917 ','plot'=>' As a regiment assembles to wage war deep in enemy territory, two soldiers are assigned to race against time and deliver a message that will stop 1,600 men from walking straight into a deadly trap.','_year'=>2018,'rating'=>8.4],
['id'=>5,'title'=>'Alien','plot'=>' After a space merchant vessel receives an unknown transmission as a distress call, one of the team\'s member is attacked by a mysterious life form and they soon realize that its life cycle has merely begun.','_year'=>1979,'rating'=>8.4]
]); $results = $index->search('space team')->get();
foreach($results as $doc) {
echo 'Document:'.$doc->getId()."\n";
foreach($doc->getData() as $field=>$value)
{
echo $field.": ".$value."\n";
}
}Result:
Document:2
year: 2014
rating: 8.5
title: Interstellar
plot: A team of explorers travel through a wormhole in space in an attempt to ensure humanity's survival.
A text search with attribute filters:
$results = $index->search('space team')
->filter('_year','gte',2000)
->filter('rating','gte',8.0)
->sort('_year','desc')
->get();
foreach($results as $doc) {
echo 'Document:'.$doc->getId()."\n";
foreach($doc->getData() as $field=>$value)
{
echo $field.": ".$value."\n";
}
}By document id:
$index->updateDocument(['_year'=>2019],4);By query:
$index->updateDocument(['_year'=>2019],['match'=>['*'=>'team']]);$index->describe();$index->drop();The above will fail if the index does not exist. To get around this pass a parameter of true, which cause the failure to be silent.
$index->drop(true);Manticore Search PHP Client is an open-source software licensed under the MIT license
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent