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.