Функции модуля cURL становятся доступны для вызова сразу после сборки PHP с поддержкой cURL. Работа с модулем cURL начинается с инициализации сеанса сетевого обмена данными вызовом функции curl_init(). Затем функцией curl_setopt() устанавливают параметры сетевой передачи и выполняют сеанс обмена данными путём вызова функции curl_exec().
Простой пример, который отправляет POST-запрос функциями модуля cURL:
Пример #1 Пример отправки POST-запроса функциями PHP-модуля cURL
<?php
$data = ['foo' => 'bar', 'baz' => 48];
$url = "http://www.example.com/handler.php";
$ch = curl_init($url);
// Указываем cURL вернуть ответ, а не отправлять в стандартный вывод
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// Устанавливаем данные и заголовок для отправки запроса HTTP-методом POST
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
// Отправляем запрос и получаем ответ
$response = curl_exec($ch);
if (curl_error($ch)) {
// Обрабатываем ошибку или бросаем исключение
throw new RuntimeException(curl_error($ch));
}Ещё один пример отправки функциями модуля cURL POST-запроса с телом в формате JSON:
Пример #2 Пример отправки функциями PHP-модуля cURL JSON-строки в теле POST-запроса
<?php
$post_data = ['foo' => 'bar', 'baz' => 48];
$url = "http://www.example.com/api/endpoint";
$ch = curl_init($url);
// Указываем cURL вернуть ответ, а не отправлять в стандартный вывод
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// Устанавливаем данные для отправки запроса HTTP-методом POST
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($post_data));
// Устанавливаем заголовок
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
// Отправляем запрос и получаем ответ
$response = curl_exec($ch);
if (curl_error($ch)) {
// Обрабатываем ошибку или бросаем исключение
throw new RuntimeException(curl_error($ch));
}Следующий пример получает начальную страницу сайта example.com функциями модуля cURL и сохраняет результат в файл:
Пример #3 Пример загрузки стартовой страницы сайта example.com функциями PHP-модуля cURL
<?php
$ch = curl_init("http://www.example.com/");
$fp = fopen("example_homepage.txt", "w");
curl_setopt($ch, CURLOPT_FILE, $fp);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_exec($ch);
if (curl_error($ch)) {
fwrite($fp, curl_error($ch));
}
fclose($fp);