curl_exec

(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)

curl_execВыполняет сеанс сетевой передачи данных

Описание

curl_exec(CurlHandle $handle): string|bool

Функция выполняет сеанс сетевой передачи данных.

Вызов функции сработает только после инициализации cURL-сеанса и установки параметров сессии.

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

handle

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

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

В случае успешного выполнения функция сбрасывает результат в стандартный поток вывода stdout и возвращает true, или false, если возникла ошибка. Однако при установке опции CURLOPT_RETURNTRANSFER и успешном завершении функция вернёт результат, или false, если возникнет ошибка.

Внимание

Функция возвращает как логическое значение false, так и нелогическое значение, которое приводится к false. Прочитайте раздел «Логический тип», чтобы получить дополнительную информацию. Используйте оператор === для проверки значения, которое возвращает функция.

Замечание:

Обратите внимание, функция не рассматривает как ошибку HTTP-коды статуса ответа наподобие 404 Not found, которые указывают на ошибки HTTP-запросов. Для проверки таких ошибок вызывают функцию curl_getinfo().

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

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

Примеры

Пример #1 Пример получения веб-страницы

<?php

// Инициализируем новый cURL-сеанс
$ch = curl_init();

// Устанавливаем URL-адрес и другие параметры сессии
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_HEADER, 0);

// Захватываем URL-адрес и передаём содержание страницы браузеру
curl_exec($ch);

// Закрываем cURL-сеанс и освобождаем системные ресурсы
curl_close($ch);

?>

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

  • curl_multi_exec() - Запускает соединения дескрипторов cURL-мультидескриптора