Codificador de URL

Codifique instantaneamente qualquer string ou URL em formato percentual para transmissão segura em requisições HTTP e parâmetros de consulta.

O que é Codificação de URL?

A codificação de URL, também conhecida como percent-encoding, é o processo de converter caracteres para um formato que possa ser transmitido com segurança pela internet como parte de uma URL. As URLs são restritas a um subconjunto específico de caracteres ASCII. Caracteres especiais — como espaços, e-comerciais, sinais de igual, barras e caracteres Unicode não-ASCII — devem ser codificados antes de serem incluídos em uma URL de forma segura.

A codificação funciona substituindo o caractere inseguro por um sinal de porcentagem (%) seguido por dois dígitos hexadecimais que representam o valor do byte ASCII ou UTF-8 do caractere. Por exemplo, um espaço ( ) torna-se %20, um e-comercial (&) torna-se %26 e uma barra (/) torna-se %2F.

A codificação de URL foi padronizada pela Internet Engineering Task Force (IETF) na RFC 3986, que define a sintaxe para Uniform Resource Identifiers (URIs). Seguir este padrão garante que as URLs sejam universalmente compreendidas por navegadores, servidores, APIs e outros clientes HTTP, independentemente do sistema operacional ou linguagem de programação envolvida.

Existem dois tipos comuns: codificação de URL (para strings de consulta, onde o espaço se torna +) e codificação de componente URI (mais estrita, onde o espaço se torna %20). Nossa ferramenta utiliza a função urlencode() do PHP, que segue o padrão application/x-www-form-urlencoded comumente usado em formulários web e APIs.

Como Usar Este Codificador de URL

  1. Cole sua entrada: Na área de texto à esquerda, digite ou cole a string, componente de URL ou valor de parâmetro de consulta que você precisa codificar.
  2. Clique em "Codificar URL": A ferramenta processará instantaneamente sua entrada e exibirá o resultado percentual codificado na caixa de saída à direita.
  3. Copie o resultado: Clique no botão Copiar Saída para copiar a string codificada para a sua área de transferência. Você pode então colá-la diretamente no seu código, cliente de API ou navegador.
  4. Limpe e repita: Use o botão Limpar para redefinir ambas as áreas de texto e começar com uma nova entrada.

Esta ferramenta funciona inteiramente no lado do servidor usando PHP, suportando todos os caracteres Unicode, incluindo árabe, chinês, japonês, cirílico e emojis — todos eles serão corretamente percent-codificados para suas sequências de bytes UTF-8.

Por Que a Codificação de URL é Importante?

A codificação de URL é um requisito fundamental no desenvolvimento web. Veja por que ela é importante em aplicações do mundo real:

  • Parâmetros de Query String: Ao construir URLs com parâmetros (ex: ?search=hello world&lang=en), caracteres especiais devem ser codificados para evitar quebrar a estrutura da URL. Um espaço não codificado faria com que a URL ficasse malformada e o servidor provavelmente retornaria um erro.
  • Requisições de API: APIs RESTful e endpoints GraphQL frequentemente recebem dados via parâmetros de URL. Qualquer entrada fornecida pelo usuário — como consultas de pesquisa, nomes de usuário ou valores de filtro — deve ser codificada para prevenir ataques de injeção e erros de parsing.
  • Submissões de Formulários: Formulários HTML com method="GET" codificam os valores dos campos automaticamente, mas ao construir URLs manualmente em JavaScript ou PHP, você deve codificar os valores por conta própria usando encodeURIComponent() ou urlencode().
  • Internacionalização (i18n): URLs contendo caracteres não-ASCII (ex: espanhol, árabe, chinês) devem ser percent-codificadas para garantir que sejam transmitidas e compreendidas corretamente por todas as implementações HTTP em todo o mundo.
  • Segurança: A codificação de URL adequada ajuda a prevenir certas classes de ataques de injeção, onde um usuário mal-intencionado pode tentar incorporar caracteres de controle ou sequências especiais em uma URL para manipular a lógica do lado do servidor.

Exemplos de Codificação de URL

Aqui estão alguns exemplos comuns de antes e depois para ilustrar como a percent-encoding transforma diferentes tipos de caracteres:

Antes (Entrada Bruta)
hello world
https://example.com/search?q=cats & dogs
[email protected]
price=£49.99
naïve résumé
Depois (URL Codificada)
hello+world
https%3A%2F%2Fexample.com%2Fsearch%3Fq%3Dcats+%26+dogs
user%40email.com
price%3D%C2%A349.99
na%C3%AFve+r%C3%A9sum%C3%A9

Observe como o espaço se torna +, o dois-pontos e as barras são codificados, e os caracteres não-ASCII (£, ï, é) são convertidos em suas representações percent-codificadas multi-byte UTF-8. Este é o formato esperado pelos servidores web e clientes HTTP ao processar query strings de URL.

Se você precisar decodificar uma URL codificada de volta à sua forma legível original, utilize nossa ferramenta Decodificador de URL.