curl_escape

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

curl_escapeEncode URL la chaîne fournie

Description

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

Cette fonction URL-encode la chaîne fournie suivant la » RFC 3986.

Liste de paramètres

handle

Un gestionnaire cURL retourné par curl_init().

string

La chaîne à encoder.

Valeurs de retour

Retourne la chaîne encodée ou false si une erreur survient.

Historique

Version Description
8.0.0 handle attend désormais une instance de CurlHandle; auparavant; une resource était attendue.

Exemples

Exemple #1 Exemple avec curl_escape()

<?php
// Crée un gestionnaire curl
$ch curl_init();

// Echappe une chaîne utilisé comme paramètre GET
$location curl_escape($ch'Hofbräuhaus / München');
// Résultat : Hofbr%C3%A4uhaus%20%2F%20M%C3%BCnchen

// Compose une URL avec la chaîne échappée
$url "http://example.com/add_location.php?location={$location}";
// Résultat: http://example.com/add_location.php?location=Hofbr%C3%A4uhaus%20%2F%20M%C3%BCnchen

// Envoi la requête HTTP et ferme le gestionnaire
curl_setopt($chCURLOPT_URL$url);
curl_setopt($chCURLOPT_RETURNTRANSFERtrue);
curl_exec($ch);
curl_close($ch);
?>

Voir aussi

add a note add a note

User Contributed Notes 3 notes

up
4
Franois
6 years ago
This function is strictly equivalent to rawurlencode().

Internally it uses curl_easy_escape() from libcurl, whose doc says: "This function converts the given input string to an URL encoded string (…). All input characters that are not a-z, A-Z, 0-9, '-', '.', '_' or '~' are converted to their "URL escaped" version (%NN where NN is a two-digit hexadecimal number)."
up
0
sam dot tyurenkov at gmail dot com
10 months ago
Please someone add an example for escaping ampersands between parameters.

E.g. what is the correct approach for using this URL with curl:
https://example.com/?p1=1&p2=2&p3=3

This is not obvious, and needs explanation.
up
-2
Nico
6 years ago
What is difference between this function and urlencode()?
To Top