array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.urlencode.php', 1 => 'urlencode', ), 'up' => array ( 0 => 'ref.url.php', 1 => 'Funciones de URL', ), 'prev' => array ( 0 => 'function.urldecode.php', 1 => 'urldecode', ), 'next' => array ( 0 => 'book.v8js.php', 1 => 'V8js', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/url/functions/urlencode.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
urlencode — Codifica como URL una cadena
Esta función es conveniente cuando se codifica una cadena a ser usada como la parte de consulta de una URL, como método práctico para pasar variables a la siguiente página.
string
La cadena a ser codificada.
Devuelve una cadena en la que todos los caracteres no-alfanuméricos
excepto -_.
han sido reemplazados con un signo de
porcentaje (%
) seguido por dos dígitos hexadecimales y
los espacios son codificados como signos de suma (+
).
Esta es la misma codificación usada en los datos publicados desde un
formulario WWW, es decir, el mismo mecanismo usado para el tipo de medios
application/x-www-form-urlencoded
. Este mecanismo
difiere de la codificación en el » RFC
3986 (vea rawurlencode()) en que, por razones
históricas, los espacios son codificados como signos de suma (+).
Ejemplo #1 Ejemplo de urlencode()
<?php
$userinput = 'Data123!@-_ +';
echo "UserInput: $userinput\n";
echo '<a href="mycgi?foo=', urlencode($userinput), '">';
?>
El resultado del ejemplo sería:
UserInput: Data123!@-_ + <a href="mycgi?foo=Data123%21%40-_+%2B">
Ejemplo #2 Ejemplo de urlencode() y ejemplo de htmlentities()
<?php
$foo = 'Data123!@-_ +';
$bar = "Not the same content as $foo";
echo "foo: $foo\n";
echo "bar: $bar\n";
$query_string = 'foo=' . urlencode($foo) . '&bar=' . urlencode($bar);
echo '<a href="mycgi?' . htmlentities($query_string) . '">';
?>
El resultado del ejemplo sería:
foo: Data123!@-_ + bar: Not the same content as Data123!@-_ + <a href="mycgi?foo=Data123%21%40-_+%2B&bar=Not+the+same+content+as+Data123%21%40-_+%2B">
Nota:
Tenga cuidado con las variables que puedan coincidir con entidades HTML. Secuencias como &, © y £ son procesadas por el navegador y la entidad real es usada en lugar del nombre de variable deseado. Este es un problema obvio sobre el cual el consorcio W3 ha estado alertando a las personas por años. La referencia esta aquí: » http://www.w3.org/TR/html4/appendix/notes.html#h-B.2.2.
PHP soporta la modificación del separador de argumentos al punto-y-coma sugerido por el W3C a través de la directiva .ini arg_separator. Desafortunadamente, la mayoría de agentes de usuario no envían datos de formularios en este formato separado por punto-y-coma. Una forma más portable es usar & en lugar de & como separador. No es necesario modificar el valor arg_separator de PHP para esto. Déjelo como &, y simplemente codifique sus URLs usando htmlentities() o htmlspecialchars().