Codificar e decodificar URL

Codificar e decodificar URLUsos e orientação prática

Codificar um URL ou componente representa caracteres que poderiam ser confundidos com separadores de endereço. Escolha o modo componente para um valor de parâmetro ou segmento e o modo URL completo quando os separadores estruturais devem permanecer. Essa escolha é importante porque um endereço completo contém caracteres com papéis específicos. Esses caracteres não devem ser tratados da mesma forma que uma frase colocada dentro de um valor de consulta. Selecione o modo de acordo com a localização dos dados.

Um ampersand dentro de um valor pode se parecer com o início de outro parâmetro quando inserido sem codificação em uma consulta. A codificação de componentes representa-o como dados. Por outro lado, codificar indiscriminadamente todos os separadores de um URL completo pode mudar a forma como o endereço é interpretado. Prepare uma amostra contendo espaços, acentos e um símbolo relevante, depois inspecione o modo escolhido. Compreender a fronteira entre a estrutura de URL e o conteúdo do componente impede muitos resultados inesperados.

Este conversor preserva um sinal de mais como um sinal de mais. Ele não aplica automaticamente a convenção de forma em que mais representa espaço. O analisador de consulta de URL lida com essa interpretação de consulta. A decodificação requer sequências de porcentagem válidas e UTF-8; uma fuga de porcentagem incompleta produz um erro. Um segundo passe de decodificação também pode mudar o significado dos dados já decodificados uma vez, então não transforme repetidamente uma string sem saber sua representação atual.

Confirme se o resultado representa o mesmo valor pretendido antes de inseri-lo no destino. A codificação não estabelece que um link existe, é seguro ou pertence a um site esperado. Ele não abre endereços ou remove dados de consulta privada. Gerador de lesma aplica uma simplificação diferente para rotas de páginas editoriais. Retenha o original e documente se a operação envolveu um componente ou um URL completo.

Uma verificação prática antes de usar o resultado

Para um parâmetro de pesquisa, teste um valor contendo um espaço e ampersand. Codifique-o como um componente e verifique se o sinal não introduz outro parâmetro quando o endereço é montado. Decodifique a amostra e compare seu conteúdo original. Para uma URL completa, inspecione separadores estruturais retidos. Antes de usar um exemplo em produção, verifique qual estágio do aplicativo já executa a codificação, já que fazê-lo muda duas vezes a representação. Mantenha o nome do parâmetro e o valor separados na documentação. Se o destino ainda exibir sequências percentuais, identifique o estágio de interpretação em vez de decodificar repetidamente sem uma regra definida. Um pequeno exemplo reproduzível é útil para distinguir erros de conteúdo de etapas de codificação incorretas.