A pesquisa de texto completa
Esta edição do Manual do PHP inclui uma possibilidade avançada de pesquisa de texto completo
fornecida pelo aplicativo visualizador. Isso permite
que os usuários pesquisem em cada palavra no arquivo de ajuda para encontrar uma
correspondência. Por exemplo, se um usuário fizer uma pesquisa de texto completo sobre a palavra
"Apache", todos os tópicos que contêm a palavra "Apache" serão listados.
A pesquisa avançada de texto completo permite que um usuário pesquise usando expressões booleanas,
curingas e aninhadas. Um usuário também pode limitar a pesquisa
a resultados anteriores, corresponder a palavras semelhantes ou pesquisar apenas títulos de tópicos.
O uso do recurso de pesquisa é bastante direto. Clique na
aba de pesquisa, digite as palavras desejadas e pressione ENTER (ou clique
em "Listar Tópicos"). Então você receberá uma lista de correspondências do
Manual do PHP (e as notas). Você pode usar o botão com uma
seta para a direita para adicionar operadores booleanos à sua pesquisa (ou você pode
digitá-los). Conforme você vê os resultados, você pode usar os títulos das colunas
(Título, Localização e Classificação) para classificar a lista de tópicos. A ordem padrão
é por Classificação. Você também pode ajustar alguns parâmetros na parte inferior desta
aba.
As palavras encontradas são destacadas na página atual no painel Tópico
por padrão. Você pode desativar esse recurso escolhendo o item de menu "Destaque
de Pesquisa Desativado" no menu Opções. Para obter esse recurso
de volta de forma semelhante. Se você estiver visualizando um tópico longo, apenas as primeiras 500
instâncias de uma palavra ou frase de pesquisa serão destacadas, devido a uma
limitação do visualizador.
Regras gerais de pesquisa
Uma pesquisa básica consiste na palavra ou frase que você deseja encontrar. Você
pode usar expressões curinga, expressões aninhadas, operadores booleanos,
correspondências de palavras semelhantes, uma lista de resultados anteriores ou títulos de tópicos para
definir melhor sua pesquisa.
As regras básicas para formular consultas são as seguintes:
As pesquisas não diferenciam maiúsculas de minúsculas, então você pode digitar sua pesquisa em letras maiúsculas ou minúsculas.
Você pode pesquisar por qualquer combinação de letras (a-z) e números (0-9).
Você não pode pesquisar por letras únicas (a, b, c, etc.) e as seguintes
palavras reservadas: an, and, as, at, be, but, by, do, for, from, have, he,
in, it, not, of, on, or, she, that, the, there, they, this, to, we,
which, with, you.
Sinais de pontuação como ponto (.), dois pontos (:), ponto e vírgula (;), vírgula (,),
e hífen (-) são ignorados durante uma pesquisa.
Agrupe os elementos da sua pesquisa usando aspas duplas ou parênteses para separar cada elemento. Você não pode pesquisar por aspas.
Se você estiver procurando por um nome de arquivo com uma extensão, você deve agrupar
a string inteira entre aspas duplas, ("arquivo.ext"). Caso contrário, o ponto
quebrará o nome do arquivo em dois termos separados. A operação padrão
entre termos é AND, então você criará o equivalente lógico para
"arquivo AND ext."
Procurando por palavras ou frases
Você pode pesquisar por palavras ou frases e usar expressões curinga.
As expressões curinga permitem que você pesquise por um ou mais caracteres
usando um ponto de interrogação ou asterisco. A tabela abaixo descreve os
resultados desses diferentes tipos de pesquisas.
Pesquisas de palavras e frases
Procurar
Exemplo
Resultados
Uma única palavra
select
Tópicos que contêm a palavra "select". (Você também encontrará suas variações gramaticais, como "selector" e "selection".)
Uma frase
"new operator" ou new operator
Tópicos que contêm a frase literal "new operator" e todas as suas variações gramaticais.
Sem as aspas, a consulta é equivalente a especificar "new AND operador", que
encontrará tópicos contendo ambas as palavras individuais, em vez da frase.
Expressões curinga
esc* ou HT??
Os resultados para o primeiro exemplo incluem tópicos que contêm os termos "ESC",
"escape", "escalation" e assim por diante. O asterisco não pode ser o único
caractere no termo.
Os resultados para o segundo exemplo incluem tópicos que contêm os termos "HTTP",
"HTML" e assim por diante. O ponto de interrogação não pode ser o único caractere no
termo.
Selecione a caixa de seleção "Match similar words" para incluir pequenas variações gramaticais
para a frase que você pesquisa. Este recurso localiza apenas variações da palavra com
sufixos comuns. Por exemplo, uma pesquisa pela palavra "add" encontrará "added", mas
não encontrará "additive". Esta opção é independente de outras opções ou sintaxe.
Se você fizer uma pesquisa somente por títulos, as variações nos títulos serão correspondidas. Se você usar
aspas (ou qualquer outro operador de consulta), qualquer variação da palavra pode aparecer; por
exemplo, "stemmed search" também corresponderá a "stemming search".
Definindo termos de pesquisa
Os operadores AND, OR, NOT e NEAR permitem que você defina precisamente sua
pesquisa criando um relacionamento entre os termos de pesquisa. A tabela a seguir
mostra como você pode usar cada um desses operadores. Se nenhum operador for especificado,
AND é usado. Por exemplo, a consulta "server cgi security" é equivalente
a "server AND cgi AND security".
Operadores de pesquisa
Procurar
Exemplo
Resultados
Ambos os termos no mesmo tópico
http AND apache
Tópicos contendo as palavras "http" e "apache".
Qualquer termo em um tópico
ming OR swflib
Tópicos contendo a palavra "ming" ou a palavra "swflib" ou ambas.
O primeiro termo sem o segundo termo
xml NOT expat
Tópicos contendo a palavra "xml", mas não a palavra "expat".
Ambos os termos no mesmo tópico, próximos um do outro
database NEAR security
Tópicos contendo a palavra "database" dentro de oito palavras da palavra "security".
Os caracteres |, & e ! também podem ser usados no lugar de OR AND e
NOT respectivamente. Isso pode não funcionar se você usar uma versão muito antiga do
visualizador.
Usando expressões aninhadas ao pesquisar
Expressões aninhadas permitem que você crie buscas complexas por informações.
Por exemplo, "html AND ((smtp OR pop3) NEAR mail)" encontra tópicos
contendo a palavra "html" junto com as palavras "smtp" e "mail"
próximas, ou contendo "html" junto com as palavras "pop3" e
"mail" próximas.
As regras básicas para pesquisar tópicos de ajuda usando expressões aninhadas são
as seguintes:
Você pode usar parênteses para aninhar expressões dentro de uma consulta. As
expressões entre parênteses são avaliadas antes do resto da consulta.
Se uma consulta não contiver uma expressão aninhada, ela será avaliada da esquerda para a direita.
Por exemplo: "mail NOT pop3 OR smtp" encontra tópicos contendo a palavra "mail" sem
a palavra "pop3" ou tópicos contendo a palavra "smtp". Por outro lado, "mail NOT
(pop3 OR smtp)" encontra tópicos contendo a palavra "mail" sem nenhuma das palavras
"pop3" ou "smtp".
Não é possível aninhar expressões com mais de cinco níveis de profundidade.