Кодирует строку для безопасного включения в структуру URL-адреса

# curl_escape

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

curl_escape — Кодирует строку для безопасного включения в структуру URL-адреса

### Описание

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

Функция кодирует части URL-адреса по стандарту » RFC 3986.

### Список параметров

`handle`
  Дескриптор модуля cURL, который вернула функция curl_init().
`string`

  Строка для кодирования.

### Возвращаемые значения

Функция возвращает экранированную строку или `false`, если возникла ошибка.

### Список изменений

Версия | Описание
--- | ---
8.0.0 | Параметр `handle` теперь принимает объект CurlHandle; раньше, параметр ждал ресурс (resource).

### Примеры

Пример #1 Пример кодирования строки функцией curl_escape()

    <?php

    // Создаём curl-дескриптор
    $ch = curl_init();

    // Экранируем строку с GET-параметрами
    $location = curl_escape($ch, 'Hofbräuhaus / München');
    // Результат: Hofbr%C3%A4uhaus%20%2F%20M%C3%BCnchen

    // Включаем заэкранированную строку в структуру URL-адреса
    $url = "http://example.com/add_location.php?location={$location}";
    // Результат: http://example.com/add_location.php?location=Hofbr%C3%A4uhaus%20%2F%20M%C3%BCnchen

    // Устанавливаем параметры и отправляем HTTP-запрос
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_exec($ch);

    ?>

### Смотрите также

- curl_unescape() - Декодирует строку, закодированную для безопасного включения в структуру URL-адреса
- urlencode() - Кодирует строку для безопасного включения в структуру URL-адреса
- rawurlencode() - URL-кодирование строки согласно RFC 3986
- » RFC 3986

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