Zend_Search_Lucene
trabalha internamente com o conjunto de
caracteres UTF-8. Arquivos de índice armazenam dados unicode no formato de codificação
"UTF-8 modificado" usado pelo Java. O núcleo do
Zend_Search_Lucene
suporta esta codificação plenamente, com uma
exceção.
[15]
A codificação dos dados de entrada pode ser especificada através da
API de Zend_Search_Lucene
. Os dados serão
convertidos automaticamente na codificação UTF-8.
De qualquer modo, o analisador de texto padrão (que também é usado no analisador de consultas) utiliza ctype_alpha() para a separação de texto e consultas em tokens.
ctype_alpha() não é compatível com UTF-8, por isso o analisador converte o texto para a codificação 'ASCII//TRANSLIT' antes da indexação. O mesmo processo é realizado transparentemente durante a análise da consulta. [16]
O analisador padrão não trata os números como parte de termos. Utilize o analisador 'Num' correspondente se você não quer que palavras sejam quebradas por números.
Zend_Search_Lucene
também contém um conjunto de analisadores
compatíveis com UTF-8:
Zend_Search_Lucene_Analysis_Analyzer_Common_Utf8
,
Zend_Search_Lucene_Analysis_Analyzer_Common_Utf8Num
,
Zend_Search_Lucene_Analysis_Analyzer_Common_Utf8_CaseInsensitive
,
Zend_Search_Lucene_Analysis_Analyzer_Common_Utf8Num_CaseInsensitive
.
Qualquer um desses analisadores pode ser ativado como o código a seguir:
Zend_Search_Lucene_Analysis_Analyzer::setDefault( new Zend_Search_Lucene_Analysis_Analyzer_Common_Utf8());
Os analisadores compatíveis com UTF-8 foram melhorados no Zend Framework 1.5. As primeiras versões dos analisadores assumiam como sendo letras todos os caracteres que não fossem ASCII. A implementação dos novos analisadores possui um comportamento mais correto.
Isso pode exigir que você reconstrua o índice para ter os dados e as consultas de pesquisas separados em tokens do mesmo formato, caso contrário o motor de busca pode retornar conjuntos de resultados errados.
Todos estes analisadores necessitam da biblioteca PCRE (Perl-compatible regular expressions) compilada com suporte à UTF-8 ativado. O suporte à UTF-8 do PCRE está ativado nas fontes da biblioteca PCRE fornecidas com o código fonte do PHP, mas se uma biblioteca compartilhada é usada em vez do pacote com as fontes do PHP, então o estado do suporte à UTF-8 vai depender de seu sistema operacional.
Use o seguinte código para verificar, se o PCRE com suporte à UTF-8 está habilitado:
if (@preg_match('/\pL/u', 'a') == 1) { echo "PCRE com suporte a Unicode está ativado.\n"; } else { echo "PCRE com suporte a Unicode está desativado.\n"; }
Versões dos analisadores compatíveis com UTF-8 insensíveis a maiúsculas e minúsculas precisam também da extensão mbstring habilitada.
Se você não quer ativar a extensão mbstring, mas precisa de buscas sem diferenciação de maiúsculas e minúsculas, pode-se usar a seguinte abordagem: normalizar os dados antes da indexação e a string de consulta antes de pesquisar, convertendo-os em minúsculas:
// Indexando setlocale(LC_CTYPE, 'de_DE.iso-8859-1'); ... Zend_Search_Lucene_Analysis_Analyzer::setDefault( new Zend_Search_Lucene_Analysis_Analyzer_Common_Utf8()); ... $doc = new Zend_Search_Lucene_Document(); $doc->addField(Zend_Search_Lucene_Field::UnStored('contents', strtolower($contents))); // Título de campo para pesquisa direta (indexado, não armazenado) $doc->addField(Zend_Search_Lucene_Field::UnStored('title', strtolower($title))); // Título de campo para recuperação (não indexado, armazenado) $doc->addField(Zend_Search_Lucene_Field::UnIndexed('_title', $title));
// Buscando setlocale(LC_CTYPE, 'de_DE.iso-8859-1'); ... Zend_Search_Lucene_Analysis_Analyzer::setDefault( new Zend_Search_Lucene_Analysis_Analyzer_Common_Utf8()); ... $hits = $index->find(strtolower($query));
[15]
Zend_Search_Lucene
suporta somente os caracteres do Plano
Multilingual Básico (BMP) (de 0x0000 a 0xFFFF), não suportando os caracteres
suplementares (caracteres acima de 0xFFFF)
O Java 2 representa estes caracteres como um par de valores do tipo char (16 bits), o primeiro vem da faixa superior (0xD800-0xDBFF), o segundo, da faixa inferior (0xDC00-0xDFFF). Logo eles são codificados como caracteres usuais UTF-8 em seis bytes. A representação padrão UTF-8 utiliza quatro bytes para caracteres suplementares.
[16] A conversão para 'ASCII//TRANSLIT' depende da localidade atual e do SO.