Codificar la cadena proporcionada para URL

# curl_escape

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

curl_escape — Codificar la cadena proporcionada para URL

### Descripción

function curl_escape(CurlHandle `$handle`, string `$string`): string|false

Esta función codifica la cadena proporcionada para URL según » RFC 3986.

### Parámetros

`handle`
  Un gestor cURL devuelto por curl_init().
`string`

  La cadena a codificar.

### Valores devueltos

Devuelve la cadena codificada o `false` si ocurre un error.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | `handle` ahora espera una instancia de CurlHandle; anteriormente, se esperaba un resource.

### Ejemplos

Ejemplo #1 Ejemplo con curl_escape()

    <?php

    // Crea un manejador curl
    $ch = curl_init();

    // Escapa una cadena utilizada como parámetro GET
    $location = curl_escape($ch, 'Hofbräuhaus / München');
    // Resultado: Hofbr%C3%A4uhaus%20%2F%20M%C3%BCnchen

    // Compone una URL con la cadena escapada
    $url = "http://example.com/add_location.php?location={$location}";
    // Resultado: http://example.com/add_location.php?location=Hofbr%C3%A4uhaus%20%2F%20M%C3%BCnchen

    // Establece las opciones y envía la petición HTTP
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_exec($ch);
    ?>

### Ver también

- curl_unescape() - Decodifica la URL proporcionada
- urlencode() - Codifica como URL una cadena
- rawurlencode() - Codificar estilo URL de acuerdo al RFC 3986
- » RFC 3986

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open