SolrClient::addDocuments
(PECL solr >= 0.9.2)
SolrClient::addDocuments — Adds a collection of SolrInputDocument instances to the index
Description
$docs
[, bool $overwrite
= true
[, int $commitWithin
= 0
]] )Adds a collection of documents to the index.
Parameters
-
docs
-
An array containing the collection of SolrInputDocument instances. This array must be an actual variable.
-
overwrite
-
Whether to overwrite existing documents or not. If
FALSE
there will be duplicates (several documents with the same ID).WarningPECL Solr < 2.0 $allowDups was used instead of $overwrite, which does the same functionality with exact opposite bool flag.
$allowDups = false is the same as $overwrite = true
-
commitWithin
-
Number of milliseconds within which to auto commit this document. Available since Solr 1.4 . Default (0) means disabled.
When this value specified, it leaves the control of when to do the commit to Solr itself, optimizing number of commits to a minimum while still fulfilling the update latency requirements, and Solr will automatically do a commit when the oldest add in the buffer is due.
Return Values
Returns a SolrUpdateResponse object or throws a SolrClientException on failure.
Examples
Example #1 SolrClient::addDocuments() example
<?php
$options = array
(
'hostname' => SOLR_SERVER_HOSTNAME,
'login' => SOLR_SERVER_USERNAME,
'password' => SOLR_SERVER_PASSWORD,
'port' => SOLR_SERVER_PORT,
);
$client = new SolrClient($options);
$doc = new SolrInputDocument();
$doc->addField('id', 334455);
$doc->addField('cat', 'Software');
$doc->addField('cat', 'Lucene');
$doc2 = clone $doc;
$doc2->deleteField('id');
$doc2->addField('id', 334456);
$docs = array($doc, $doc2);
$updateResponse = $client->addDocuments($docs);
// no changes will be written to disk unless $commitWithin is passed or SolrClient::commit is called
print_r($updateResponse->getResponse());
?>
The above example will output something similar to:
SolrObject Object ( [responseHeader] => SolrObject Object ( [status] => 0 [QTime] => 2 ) )
See Also
- SolrClient::addDocument() - Adds a document to the index
- SolrClient::commit() - Finalizes all add/deletes made to the index
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Расширения для работы с поисковыми системами
- Apache Solr
- Функция SolrClient::addDocument() - Adds a document to the index
- Функция SolrClient::addDocuments() - Adds a collection of SolrInputDocument instances to the index
- Функция SolrClient::commit() - Finalizes all add/deletes made to the index
- Функция SolrClient::__construct() - Constructor for the SolrClient object
- Функция SolrClient::deleteById() - Delete by Id
- Функция SolrClient::deleteByIds() - Deletes by Ids
- Функция SolrClient::deleteByQueries() - Removes all documents matching any of the queries
- Функция SolrClient::deleteByQuery() - Deletes all documents matching the given query
- Функция SolrClient::__destruct() - Destructor for SolrClient
- SolrClient::getById
- SolrClient::getByIds
- Функция SolrClient::getDebug() - Returns the debug data for the last connection attempt
- Функция SolrClient::getOptions() - Returns the client options set internally
- Функция SolrClient::optimize() - Defragments the index
- Функция SolrClient::ping() - Checks if Solr server is still up
- Функция SolrClient::query() - Sends a query to the server
- Функция SolrClient::request() - Sends a raw update request
- Функция SolrClient::rollback() - Rollbacks all add/deletes made to the index since the last commit
- Функция SolrClient::setResponseWriter() - Sets the response writer used to prepare the response from Solr
- Функция SolrClient::setServlet() - Changes the specified servlet type to a new value
- SolrClient::system
- Функция SolrClient::threads() - Checks the threads status
Коментарии
If you want to add a bunch of documents from a database, this would be the way to go, assuming you have fetched the records from the database and put them in an array called $recordset:
<?php
foreach ($recordset as $key=>$value){
$docs_array[$key] = new SolrInputDocument();
$docs_array[$key]->addField('id', $value['document_id']);
$docs_array[$key]->addField('name',$value['document_name']);
}
$client->addDocuments($docs_array);
?>