(PECL solr >= 0.9.2)
SolrClient::addDocument — Adiciona um documento ao índice
$doc
, bool $overwrite
= true
, int $commitWithin
= 0): SolrUpdateResponseEste método adiciona um documento ao índice.
doc
A instância SolrInputDocument.
overwrite
Informa se o documento existente deve ou não ser substituído. Se false
, haverá duplicatas (vários documentos com o mesmo ID).
PECL Solr < 2.0 $allowDups foi usado em vez de $overwrite, que faz a mesma funcionalidade com a opção booleana exatamente oposta.
$allowDups = false é o mesmo que $overwrite = true
commitWithin
Número de milissegundos para confirmar automaticamente este documento. Disponível desde Solr 1.4. Padrão (0) significa desabilitado.
Quando este valor é especificado, ele deixa o controle de quando fazer a confirmação para o próprio Solr, otimizando o número de confirmações ao mínimo enquanto ainda atende aos requisitos de latência de atualização, e o Solr fará uma confirmação automaticamente quando a adição mais antiga no buffer estiver pendente.
Retorna um objeto SolrUpdateResponse ou lança uma exceção em caso de falha.
Lança SolrClientException se o cliente falhar ou houver problema de conexão.
Lança SolrServerException se o servidor Solr falhar ao processar a solicitação.
Exemplo #1 Exemplo de SolrClient::addDocument()
<?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');
$updateResponse = $client->addDocument($doc);
// As alterações a serem escritas deve ser confirmadas se $commitWithin não tiver sido usado
$client->commit();
print_r($updateResponse->getResponse());
?>
O exemplo acima produzirá algo semelhante a:
SolrObject Object ( [responseHeader] => SolrObject Object ( [status] => 0 [QTime] => 1 ) )
Exemplo #2 Exemplo 2 de SolrClient::addDocument()
<?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');
// Não há necessidade de chamar commit() porque $commitWithin foi informado, assim o Solr Server irá confirmar automaticamente em 10 segundos
$updateResponse = $client->addDocument($doc, false, 10000);
print_r($updateResponse->getResponse());
?>
O exemplo acima produzirá algo semelhante a:
SolrObject Object ( [responseHeader] => SolrObject Object ( [status] => 0 [QTime] => 1 ) )